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!!!