X-Git-Url: http://git.indexdata.com/?p=mkws-moved-to-github.git;a=blobdiff_plain;f=README;h=7aacc48b0ef57af4397bfa263968f47727bc3df2;hp=370c54ebf8e18b60a8785bda3939c01951ba3ac4;hb=8ecc7b5621fa3f7191205e6ce93a8ef097e873bd;hpb=3360a31122525a9e7c0a32e3e93e1db34a777d73

diff --git a/README b/README
index 370c54e..7aacc48 100644
--- a/README
+++ b/README
@@ -5,22 +5,40 @@ The MasterKey Widget Set, or MKWS, is a project to create some very
 simple HTML/JS/CSS widgets that can be dropped into ANY website,
 irrespective of CMS or lack thereof, to enable MasterKey searching.
 
-The top level bug for discussing this is
-        https://jira.indexdata.com/browse/MKWS-1
-and a high-level description can be found at
-        https://twiki.indexdata.com/twiki/bin/view/ID/MasterKeyWidgetSet
-
 
 WHAT'S WHAT
 ===========
 
-experiments -- a directory containing code experiments:
-	jquery-ui -- Using a JQuery UI element
-	jsdemo -- The basic pazpar2 client, running locally
-	spclient -- Mike's hardly-there sketch
-	spdemo -- Wolfram's functioning jsdemo-targeted-at-SP
+README   -- this file
+Makefile -- delegates to tools/htdocs/Makefile
+tools 	 -- the tools that make up the Widget Set
+examples -- examples of applications that use MKWS
+
+notes    -- internal documents, not for customers
+
+
+Required devel tools
+====================
+
+On debian, you will need:
+$ sudo apt-get install curl git-core pandoc yui-compressor node-js libbsd-resource-perl
+
+On Debian 7 (wheezy), you do not need git-core, plain git will do, but
+you probably have that on a development box already. Unfortunately, node-js
+is not available for wheezy. Either you can get it from wheezy-backports,
+or you can download the source from http://nodejs.org/download/ and build
+it yourself. Looks like you need node and npm, make install puts them
+into /usr/local/bin.
+
+To compile the default templates you'll need to install the stable version
+of Handlebars. Currently it's at 1.3.0 and available by npm:
+
+  npm install handlebars@1.3.0 -g
+
+For apache setup, see tools/apache2/README
+
+NEWS
+=========
 
-etc -- configuration files for the various experiments
-	apache2 -- configuration for running spdemo
-	service-proxy -- config for running a local Service Proxy
+see tools/htdocs/NEWS