more doc

diff --git a/README b/README
index e7b5192..18f7ac9 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,6 @@
-The contents of this module:
+This file documents the contents of this module
+
+See devel/ for more devel-oriented doc.
 
 ==================== 1st level subdirs
 * myslice: 

diff --git a/devel/django-install.txt b/devel/django-install.txt
index 72e83d2..fcdbd2a 100644 (file)
--- a/devel/django-install.txt
+++ b/devel/django-install.txt
@@ -1,4 +1,4 @@
-versions collected as of nov 14 2012
+Versions collected as of nov 14 2012
 
 ======================================== MAC
 I'm using macports 
@@ -43,8 +43,4 @@ and I was getting a lot of warnings relating to that anyways
 . manage.py syncdb
 . manage.py collectstatic --noinput
 
-======================================== django-insert-above
-this package was downloaded in source doce from github and installed
-as-is as insert_above, and enabled as the README has it
-
-======================================== 
+====================

diff --git a/devel/run-locally.txt b/devel/run-locally.txt
new file mode 100644 (file)
index 0000000..4709ce9
--- /dev/null
+++ b/devel/run-locally.txt
@@ -0,0 +1,20 @@
+In order to run this module in standalone mode
+
+ * install python and django for your OS (see devel/django-install.txt)
+
+ * make syncdb
+ that won't hurt
+
+ * make collectstatic
+ although this is not really needed anymore now that we have a single
+ location for tempaltes and static, but if any static file gets added
+ in some other place, this will be important
+
+ * manage.py runserver 0.0.0.0:8080
+ for a one-shot run of the local server
+
+ * if you need to often restart the server, you can use 
+ devel/server-loop.sh
+ that runs 'manage runserver ...' in an endless loop, just hit ctrl-C
+ to kill the current server instance and run another one
+