GitHub

NOTE: We are actively transitioning all our repositories from Bitbucket to GitHub to streamline our version control and collaboration processes.

This page is your guide to understanding and making the most of GitHub’s features in our workflow.

What is GitHub?

GitHub is a web-based platform used for version control using Git. It facilitates software development, offering a range of tools and features that enhance collaboration and project management among developers. GitHub allows us to store, manage, and track changes to our source code while facilitating teamwork.

How do we use GitHub at Planet Argon?

We utilize GitHub’s features to streamline our software development processes in a few different ways:

• Organizations:

  GitHub allows us to create and manage organizations representing a client, project, or application. These organizations house various repositories and assist in managing user and team permissions efficiently. We currently use the Planet Argon organization to manage client repos, and have a few project- or app-specific teams within that org.

  

• Project Repositories:

  Project repositories are either controlled by the Planet Argon organization or by a client org. In the case of the latter, access permissions have been granted to either the entire Planet Argon org or certain members of the engineering team.

  

  Let your project manager know if you need access to a specific client repo not owned by the Planet Argon organization.

• Branching and Pull Requests:

  We use GitHub to handle merging and pruning of various development branches. You can switch between branchs in a repo under the “Branch” dropdown menu. Remember to follow the Planet Argon branch naming conventions and fill out the pull request template as thoroughly as you can.

  

• Actions and CI/CD:

  GitHub Actions facilitates CI/CD, automating our software deployment pipeline. We craft workflows to build, test, and deploy our code automatically, ensuring robust and reliable software delivery.

  

• Access Controls:

  GitHub lets us define specific access control levels, ensuring secure collaboration by assigning appropriate permissions to team members at various levels, such as organization, repository, or team levels.

  

• Integration:

  GitHub offers integrations with a number of our regular third-party tools, including Jira, Codecov, Code Climate, and more.