X-Git-Url: http://git.indexdata.com/?p=mkws-moved-to-github.git;a=blobdiff_plain;f=README;h=5b6a98b4a9535af989053cb35fd5603f44d89e9e;hp=0823a10ffac5a5ef039707fcfc71302ece7939ab;hb=4f4020ed0de121934f9118d533c5ab9b3ecaa79e;hpb=7bd78d587eda7b6d86319b466230c2b885608929

diff --git a/README b/README
index 0823a10..5b6a98b 100644
--- a/README
+++ b/README
@@ -1,9 +1,50 @@
-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
+OVERVIEW
+========
+
+The MasterKey Widget Set, or MKWS, provides HTML/JS/CSS widgets that
+can be dropped into ANY website, irrespective of CMS or lack thereof,
+to enable MasterKey searching. See the contents of the "doc" directory
+for further documentation.
+
+
+WHAT'S WHAT
+===========
+
+README   -- this file
+LICENSE  -- The GNU LGPL (Lesser General Public Licence)
+Makefile -- delegates to tools/htdocs/Makefile
+src      -- source-code that is compiled into the tools area
+tools 	 -- the tools that make up the Widget Set
+examples -- examples of applications that use MKWS
+doc      -- documentation (in Markdown, compiles to HTML)
+test     -- regression-testing scripts
+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. You need node and npm, its package manager: 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 2.0.0 and available by npm:
+
+  npm install handlebars@2.0.0 -g
+
+For apache setup, see tools/apache2/README
+
+
+NEWS
+====
+
+see tools/htdocs/NEWS
+