Skip to content

Latest commit

 

History

History
28 lines (20 loc) · 2.87 KB

Creating-Repos.md

File metadata and controls

28 lines (20 loc) · 2.87 KB
title description author
Starting a New Repository
Everything you need to know about creating a blank project in the BCGov Org.
kelpisland

Creating a Repo

Once you are part of the BCGov Organization you might just want to get going on making some stuff. To do that you'll need a Repository (Repo).

If you are creating an empty project on day one, you're on the "happy path." If you are looking to upload and open stuff that was already made by BC Government employees, contractors, vendors or friends you will have a bit more work to do. In both cases you will need to go through the Content Approval Checklist (link coming soon) before you can get started.

  • First you will have to enable two-factor authentication for your GitHub account.
  • Two factor authentication can be achieved using mobile apps, SMS or a variety of desktop applications. There are excellent instructions here to help you get that done.
  • Then you will need to email the BCGov Org contact (see the email link at the top of the BCGov Org Page) and ask to be added to an admin team for the BCGov GitHub organization.
  • Now, when you create a new repo you need to select ‘BCGov’ as the owner (not your employee account).
    • Therefore, content added to the repo is ‘owned’ in GitHub terminology by BCGov, not the employee.
    • There are things to consider when naming your repo that were a good fit for a seperate "How To" that lives here
  • You will need to add the minimum content (License, Readme, and contributing files) to your repo before you get going on any project activities.

This process addresses legal concerns about content and security concerns about what would happen if an employee decides to close their GitHub account in the future. However, if an administrator deletes a repo in addition to closing their account, the repo itself and its contents are gone forever.

You will notice a log entry in the repo indicating who authored the repo (GitHubUserName authored 2 days ago). This simply indicates who created the repo, not ownership.

GitHub provides simple instructions here for creating repo's if you need more info.

Managing Repo Access

Once you have the repo created, next thing is to assign a repo admin. Please make sure at least one repo admin exist at anytime. If you are using GitHub teams to manage your team members, please have the team maintainer to request access for the rest of the team. (see these instructions.)