add sections about development and testing

Author: iromli

README.md

@@ -3,8 +3,32 @@ User Map
 
 A simple application for creating user community maps powered by Flask.
 
-Hacking
--------
+Installation
+------------
+
+Prerequisites:
+
+* Python 2.7.x
+* PostgreSQL or MySQL database
+* pip and (optional) virtualenv
+
+Once you have all prerequisites, the following steps will bootstrap the project:
+
+1.  Grab the source code.
+
+        git clone git://github.com/id-python/members.git
+        cd members
+
+2.  Activate your virtual environment (or you can skip this step if you're not using `virtualenv`).
+
+3.  Install all dependencies using `pip`:
+
+        pip install -r requirements.txt
+
+Note: the installation process may take awhile.
+
+Development
+-----------
 
 By default, this app reads configuration from `users/default_config.py`.
 To override values set in default config, simply copy the contents
@@ -16,28 +40,42 @@ Then edit the custom config file, setting appropriate values as needed.
 
 Things you might need to override:
 
-* `SQLALCHEMY_DATABASE_URI` — refer to http://docs.sqlalchemy.org/en/rel_0_9/core/engines.html for details
+*   `SQLALCHEMY_DATABASE_URI`
+
+    Since this project tested using PostgreSQL and __likely__ will running on MySQL as well,
+    there's extra package you need to install to before running the app.
 
-To install dependencies:
+    * `pip install psycopg2` for PostgreSQL
+    * `pip install mysql-python` for MySQL
 
-    pip install -r requirements.txt
+    Just pick one and please refer to http://docs.sqlalchemy.org/en/rel_0_9/core/engines.html for details.
 
-Before running the server/testcase, ensure database is up-to-date:
+Ensure your database schema is up-to-date by invoking this command:
 
     USERS_CONFIG=/path/to/custom/config.py python manage.py db upgrade
 
-To run the development server:
+Running the app will be as simple as:
 
     USERS_CONFIG=/path/to/custom/config.py python manage.py runserver
 
 Each config item is overridable through environment variable.
 For instance, if you want to suppress email delivery, simply set appropriate value:
 
-    USERS_CONFIG=/path/to/custom/config.py USERS_MAIL_SUPPRESS_SEND=True python manage.py runserver
+    USERS_CONFIG=/path/to/custom/config.py USERS_MAIL_SUPPRESS_SEND=1 python manage.py runserver
+
+Testing
+-------
+
+NOTE: It is highly-recommended that you're creating a separate database and config file for testing.
 
 To run testcases:
 
-    USERS_CONFIG=/path/to/custom/config.py USERS_MAIL_SUPPRESS_SEND=True ./runtests.sh
+    USERS_CONFIG=/path/to/custom/testing_config.py ./runtests.sh
+
+Each config item is overridable through environment variable.
+For instance, if you want to suppress email delivery, simply set appropriate value:
+
+    USERS_CONFIG=/path/to/custom/testing_config.py USERS_MAIL_SUPPRESS_SEND=1 ./runtests.sh
 
 Collaboration
 -------------