This document discusses how the open source project Joind.In uses GitHub to manage its codebase and development. It summarizes key aspects of GitHub like version control, code repositories, wikis, pull requests, and issue tracking. The document outlines how Joind.In utilizes GitHub features for its wiki, source code hosted in a main repository with forks, and issue tracking on JIRA instead of GitHub. It also discusses how the project uses mailing lists, IRC, and transparency to engage its community.

1. Running a Project with Github

2. About Me
● Lorna Jane Mitchell
● Co-Project Lead on Joind.In
● Freelance PHP Consultant/Evangelist
● Twitter: @lornajane
● Site: http://www.lornajane.net

3. The Project: Joind.In
● Instant, public feedback for events
● http://joind.in
● Open source - hosted on github

4. GitHub
● http://github.com
● "Online project hosting using Git. Includes
source-code browser, in-line editing, wikis, and
ticketing. Free for public open-source code."

5. Version Control
● Keeping-place
● Collaboration tool
● History

6. Centralised Version Control

7. Distributed Version Control

8. GitHub
● Provides supporting tools to track
● users
● repos
● changes
● documents
● source code
● http://github.com/joindin/joind.in

9. Joind.In on Github
● Wiki
● Source Code
● Bug tracking is actually on JIRA
● Mailing lists and IRC

10. Wiki
● Overview
● Contributors' guide
● Roadmap

11. Source Code
● One main repo
● project leads have commit access
● Users fork to own github repo
● Changes come back via pull requests

12. Source Code Contributions
● One branch per changeset
● Branch naming conventions
● Guidelines from ZF:
● http://framework.zend.com/wiki/display
ZFDEV2/Zend+Framework+Git+Guide

13. Bug Tracking: JIRA
● Migrated away from github
● Atlassian offers free accounts for open source
● Issue owners
● Issue status

14. Mailing Lists
● Key link to community
● Transparency
● Users as well as developers

15. IRC
● Developers mostly
● #joind.in on freenode

16. Openness
● IRC + mailing lists
● Features under consideration
● Platform/hosting changes

17. Projects on GitHub
● Great central resource
● Maturing tool
● Technology is not the whole answer

18. Thanks!