add demo README

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..5651454
--- /dev/null
+++ b/README
@@ -0,0 +1,22 @@
+So far, this includes a basic HTTP server based on SimpleHTTPServer:
+    python httpd.py -d
+
+and a JSONRPC test application:
+    python jsonapp.py
+
+The latter is where it gets interesting.  Session cookies are automatically
+used to create application instances which are persistent in memory
+(TODO: drop them after an application-specified timeout of course...)
+
+As this is an entirely single-process application, it's perfectly possible
+to keep large complex data structures around that would otherwise be
+impossible to serialise (such as data structures from c-based python modules,
+or persistent database connection objects).
+
+One of the reasons why this code has been put together is so that GNUmed
+can keep per-user persistent database connections open, where the user
+credentials are *different* on a per-user basis.  GNUmed uses postgresql
+"roles" for security purposes, and thus a "global database connection"
+which is the "norm" for most web-based database frameworks, is completely
+useless.
+