For a user who hasn't yet created a GitHub account, follow these directions:
- If you haven't created a GitHub account yet (https://github.com/), do so with your government email, which will assist with records retention.
- If you already have a GitHub account, simply add your goverment email to your existing account. Do not create a new account. You can also set up custom email routing through the Notifications Center. Make sure your commits are associated with your government email address.
- Update the
Settings
in your account to match the GSA Standards. - Note that associating commits with an email address is different from setting notifications to go to one or another email address. You also have to change the official commit email address attached to each repo.
- If you’re using your work computer for personal projects on GitHub and want your personal email tied to those commits, you can set your GSA email as part of the global
.gitconfig
, then override on a repository level with your personal email. If you have both emails in your GitHub settings, though, they will both be tied to your GitHub account. - Make sure you have notifications turned on and make sure your notifications are set up they way you'd like them.
- Ensure that you have created a GitHub account that matches the standards above.
- If your group already has a team in the GSA organization, ask your point of contact to email '[email protected]' with your Github username and request that you be given access.
- If your group does not yet have a team in the GSA organization, email '[email protected]' to coordinate a team be created. You will need to list the usernames of any others who should be added.
- You will receive a notification when you've been given access.
- At https://github.com/digitalgov, Click
+ New Repository
. - When choosing the repo's name, try to pick a simple and useful name
- Include a brief description of the project.
- Change the repo status to
Public
unless it does must be private. - It is usually convenient to check the box to
Initialize this repository with a README
. - You will usually not need to worry about adding a
.gitignore
. - Please choose the type of license from the dropdown. For a description of the license types, see https://help.github.com/articles/licensing-a-repository
- Click Create Repository
- If prompted, choose the most appropriate team that you are a member of that should be given permission to the repo.