Update README

This was in dire need of a rewrite, so it gets one here.

Signed-off-by: Dan McGee <dan@archlinux.org>

1 files changed, 59 insertions, 22 deletions

diff --git a/README b/README
index ec0829e9..fd493b68 100644
--- a/README
+++ b/README
@@ -1,35 +1,72 @@
+# Archweb README
+
+To get a pretty version of this document, run
+
+    $ markdown README > README.html
+
 # License
- See LICENSE file.
+
+See LICENSE file.
 
 # Authors
- See AUTHORS file.
+
+See AUTHORS file.
 
 # Dependencies
- - python
- - mysql-python or python-pysqlite
- - Django >= 1.2.X
 
-# Installation
-For a simple testing installation:
+- python
+- python-virtualenv
+
+# Python dependencies
+
+More detail in `requirements.txt` and `requirements_prod.txt`; it is best to
+use virtualenv to handle these. But if you insist on (Arch Linux) packages, you
+will probably want the following:
+
+- mysql-python or python-pysqlite
+- django
+- python-markdown
+- python-south
+- python-memcached
+
+# Testing Installation
+
+1. Run `virtualenv`.
+
+        $ cd /path/to/archweb && virtualenv ../archweb
 
- 1. Install dependencies.
-    $ pacman -S django python-pysqlite sqlite3
- 
- 2. Copy local_settings.py.example to local_settings.py and modify.
-    Make sure to uncomment the appropriate db section (either sqlite or mysql).
+2. Install dependencies through `pip`.
 
- 3. Sync the database to create it.
-    $ python manage.py syncdb
+        $ pip -r requirements.txt
 
- 4. Load the fixtures to prepopulate some data.
-    $ python manage.py loaddata arches.json repos.json
+3. Copy `local_settings.py.example` to `local_settings.py` and modify.
+   Make sure to uncomment the appropriate db section (either sqlite or mysql).
+
+4. Sync the database to create it.
+
+        $ python manage.py syncdb
+
+5. Migrate changes.
+
+        $ python manage.py migrate
+
+6. Load the fixtures to prepopulate some data.
+
+        $ python manage.py loaddata main/fixtures/arches.json main/fixtures/repos.json
     
- 5. Use the following commands to start a service instance
-    $ python manage.py runserver
+7. Use the following commands to start a service instance
+
+        $ python manage.py runserver
+
+8. To optionally populate the database with real data:
+
+        $ wget ftp://ftp.archlinux.org/core/os/i686/core.db.tar.gz
+        $ ./manage.py reporead i686 core.db.tar.gz
+
+Alter architecture and repo to get x86\_64 and packages from other repos if needed.
 
- 6. To optionally populate the database with real data:
-    $ wget ftp://ftp.archlinux.org/core/os/i686/core.db.tar.gz
-    $ ./manage.py reporead i686 core.db.tar.gz
+# Production Installation
 
-    (alter architecture and repo to get x86_64 and extra packages if needed)
+Ask someone who knows, or you are going to be in trouble.
 
+vim: set syntax=markdown et: