--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.txt	Sat Jun 11 22:37:32 2011 -0700
@@ -0,0 +1,196 @@
+WSGI Software
+=============
+
+wsgintegrate provides an integration layer to support general-purpose
+WSGI pipes 
+
+
+wsgintegrate core
+-----------------
+
+- pyloader: utilities for loading and calling python objects
+
+- wgintegrate:
+  : provides: dispatcher
+  : requires: pyloader, paste
+  : type: app
+
+- paste: WSGI server and utilities
+  : provides: fileserver, server
+
+
+site management and deployment
+------------------------------
+
+- buttercup: the flower containing the deployment pattern for k0s.org;
+  currently, there is only one flower, but it will eventually be
+  generalized to a meta-pattern; see http://k0s.org/hg/wsgintegrate/file/tip/flowerbed.txt
+  : url: http://k0s.org/hg/buttercup/
+  : provides: k0s.org
+  : type: flower
+
+
+- flowerbed: vaporware stubbing for the flower project; see buttercup, above
+  : provides: flowers
+  : url: http://k0s.org/hg/flowerbed/
+
+- silvermirror: mirror portions of filesystems with unison
+  : url: http://k0s.org/hg/silvermirror/
+  : provides: sync
+  : requires: unison
+  : type: script
+
+- wsgiblob: a precursor of wsgintegrate and pyloader
+  : url: http://k0s.org/hg/wsgiblob/
+  
+
+WSGI Endpoint Apps
+------------------
+
+- bitsyblog: blogging app.
+  : provides: blog
+  : requires: auth
+
+- clwapp: convert a CLI script into a WSGI app
+  : url: http://k0s.org/hg/clwapp/  
+  : type: app
+
+- decoupage: dynamic file server
+  : provides: fileserver
+  : requires: paste, contenttransformer
+
+- montage: photo gallery extension to decoupage
+  : requires: decoupage
+
+- SimpleWiki: a basic wiki
+  : url: http://k0s.org/hg/SimpleWiki/
+  : provides: wiki
+
+- toolbox: content categorizer
+  : type: app
+
+- uploader: upload files to your website
+  : url: http://k0s.org/hg/uploader/
+  : provides: uploading
+  : type: app
+
+- webcalc: do calculations via the path info
+  : url: http://k0s.org/hg/webcalc/
+  : provides: math
+  : type: app, unfinished
+
+- wordstream: dissociate via url or input or play with a stream of
+  words
+  : url: http://k0s.org/hg/wordstream/
+  : type: app
+
+
+WSGI Middleware apps
+--------------------
+
+- Commentator: comment on mostly arbitrary URLs
+  : url: http://k0s.org/hg/commentator/
+  : provides: comments
+  : requires: lxmlmiddleware
+  : type: app, middleware
+
+- SVG site map: make an SVG directed graph counting HTTP references 
+  : url: http://k0s.org/hg/svgsitemap/
+  : provides: directed graph
+  : dependencies: graphviz
+
+- Tag In the Middle: configure tagging on various element -> URL
+  mappings of your site
+  : provides: tags
+  : requires: lxmlmiddleware
+
+
+Utilities
+---------
+
+- bitsyapps: do various things with your bitysblog post
+  : url: http://k0s.org/hg/bitsyapps/
+  : provides: write to file
+  : requires: bitsyblog
+  : type: plugin, unfinished
+
+- bitsyauth: simple authentication middleware
+  : type: auth, middleware
+
+- bitsytweet: tweet your bitsyblog posts; currently broken: see
+  http://k0s.org/blog/20101125140133
+  : url: http://k0s.org/hg/bitsytweet/
+  : provides: tweets
+  : requires: bitsyblog
+  : type: plugin, broken
+
+- CAPTCHA Middleware: provide a CAPTCHA-based authentication token
+  with middleware
+  : url: http://k0s.org/hg/CAPTCHAmiddleware/
+  : provides: auth
+  : type: middleware, unfinished
+
+- contenttransformer: dynamically transform content from one type to
+  another
+  : url: http://k0s.org/hg/contenttransformer/
+  : type: middleware
+
+- cropresize: transform an image size appropriate for web content
+  : url: http://k0s.org/hg/cropresize/
+  : requires: image
+
+- hgpaste: serve mercurial repositories as WSGI apps
+  : provides: version control
+  : requires: paste
+  : type: app
+
+- lxmlmiddleware: decompose an XML/HTML response into via lxml for processing
+  : url: http://k0s.org/hg/lxmlmiddleware/
+  : dependencies: lxml
+  : type: middleware
+
+- redirectall: redirect all traffic as moved permanantly
+  : url: http://k0s.org/hg/redirectall
+  : provides: redirection
+  : requires: paste
+
+- redirector: WSGI middleware for handling redirection
+  : url: http://k0s.org/hg/redirector/
+  : provides: redirection
+  : type: middleware
+
+- relocator: fill out location headers on the way out given a base url
+  : url: http://k0s.org/hg/relocator/
+  : provides: redirection
+  : type: middleware
+
+- theslasher: remove trailing slashes from requests via redirection
+  : url: http://k0s.org/hg/theslasher/
+  : provides: redirection
+  : type: middleware
+
+- webob: WSGI request/response objects
+  : provides: request, response
+
+
+Templates
+---------
+
+Either template engines or templates that use them
+
+- genshi: template rendering engine
+  : url: http://genshi.edgewall.com
+  : provides: templates
+
+- genshi view: a simple webob view with genshi + tempita templates
+  : provides: app, middleware, jquery
+  : requires: webob, genshi, tempita
+  : url: http://k0s.org/hg/genshi_view/
+
+- tempita: simple template engine
+  : provides: templates
+
+- webob view: a simple webob view
+  : url: http://k0s.org/hg/webob_view/
+  : provides: app, middleware
+  : requires: webob