Create a new repository for any logically separate piece of code. We can have zillions of repositories. You have two options; one is to create the repository directly with Khan, the other is to create it on your own github account and then fork to Khan. I (csilvers) think the former is preferred, but you will need admin permissions on the github repository to do it.
- Go to our github admin home at https://github.com/organizations/Khan
- You should see a sidebar on the right that says "Repositories (##)" and has a "New repository" button right next to it. If you don't see the button, you don't have the necessary permissions. Ask someone for them.
- Click "New repository". Fill out the info. Make it a public repository (if you think it needs to be private, check with some experienced devs first to make sure that's the right thing to do). Add it to the appropriate 'team' in the teams drop-down. If you don't see a good fit, you can create a new team at https://github.com/organizations/Khan/teams.
Once you have created the appropriate repository, hook it up with HipChat -- that way there will be messages every time a commit is made. To do this, go to
- If you want to change the teams later, you can do it at
https://github.com/Khan/<project name>/admin/hooks, and click on the HipChat service. You will need to fill in the auth key and the room name. The auth key is in secrets.py. Pick the appropriate HipChat room for this project, or default to "1s and 0s". Click on "Active". Make sure "Notify" is not checked -- we don't want hipchat to beep at you when these updates come in. Click "Update Settings". The dot next to HipChat should be green. Click on HipChat again, and click on the "Test Hook" button. You should see a message show up in HipChat!