GitHub Organization Access
The Civic Tech DC GitHub Organization is where most projects store their code. In keeping with our open source tenet, most repositories are public, but write, maintain, and admin access is restricted to each project’s maintainers.
How you get access depends on how involved you are with a project. There are three roles, and the rest of this page covers how to set things up for each.
| Role | Access | Who it’s for |
|---|---|---|
| Initial Contributor | No special access; contributes via forks and pull requests | First-time and occasional contributors |
| Maintainer | Write access, via the project’s GitHub Team | Regular contributors on the project |
| Admin | Full admin control of the repositories | Project leads (keep at least 2) |
Contributors
Section titled “Contributors”Initial Contributors
Section titled “Initial Contributors”If you’re contributing for the first time, you don’t need any special access. Fork the repository and open a pull request from your fork back to the main repository. A maintainer will review it from there.
Maintainers
Section titled “Maintainers”Regular contributors are added to a GitHub Team for the project (what counts as a maintainer varies by project). Everyone on the team gets at least write access to the project’s repositories, so they can push branches and merge approved pull requests.
Admins
Section titled “Admins”Admins have full control of a repository, including managing access and settings. These are usually the project leads.
How To
Section titled “How To”Create a Team
Section titled “Create a Team”Contact @Evan Tung on Slack to create a team. The GitHub team name will match your project name unless you specifically request otherwise.
Create a Repository
Section titled “Create a Repository”Contact @Evan Tung on Slack to create a repository, and include the repository name you’d like. You’ll be made an Admin of the new repository, from which you can add another Admin and grant the project’s GitHub team access.
Give Access to a New Contributor
Section titled “Give Access to a New Contributor”Any Admin of the project’s GitHub team can add a new Maintainer. In GitHub, go to the Civic Tech DC Organization → Teams → your team, then click “Add a Member.”
Offboard from a Project
Section titled “Offboard from a Project”Leaving a project you help maintain? Before you go, assign another Admin on every repository you’re an Admin of. That way each repository keeps at least 2 Admins and the project never loses access.