This is the source code behind http://the.randomchatroom.net


Who can contribute and how?  
----------------------------
Anyone who is interested... this is a learning project and social experiment :)  We are all various level of n00bs here.  Feel free to
ask questions in the chatroom or on the google group - don't be shy ;)

Please join the google group for help on getting involved http://groups.google.com/group/randomchatroom

To run this application locally:
--------------------------------

# Make sure python is installed (not python 3)
# Install nose (python library for running tests)
# Install Google App Engine SDK
# Fork this repository
# Clone that repository onto your local machine
# Run the tests with the command `nosetests`

If you have any issues, ask in the chat room or email randomchatroom@googlegroups.com

Learning resources
-------------------
You'll need to get up to speed with git, python and Google App Engine and have them installed. Don't use python 3.

To learn git we recommend you try:

http://gitimmersion.com (has instructions on which git client to install)

To learn Google App Engine (as well as how to run it locally) do the Getting Started - Python tutorial from the Google App Engine website.

To learn python we recommend .. ??? there are heaps of resources out there (dive into python is a free book but geared more to those who already know
programmig), I don't know of a really good one sorry.

Access to app statistics
------------------------
If you're interested in viewing the google app engine dashboard for this project, or the google analytics statistics, shoot a gmail to starkcoffee 

This is how we work:
--------------------

# Do your changes to your local repository that you cloned from your fork (yeh.. mouthful!)
# Test your changes on your local google app engine
# Commit them to your local repository
# Push them to your forked repositoy on github
# Do a pull request via github so that your changes get incorporated into this (the authorative) repository
# A gatekeeper will then deploy them (in time there will be more core committers and deployers)

Info on how to fork - http://help.github.com/fork-a-repo/ 

Why are there no tests??
------------------------
Yeh... good point .. :/ :/ :?  COMING SOON!!!