Github

This page explains what GitHub is, how we collaborate through repositories, branches and commits, and the practices we follow to keep our projects organized and maintainable.

What is Github?

GitHub is Terra’s main platform for version control and collaboration. It’s where all project code lives and where the team works together to build, review, and deploy features safely.

We use GitHub to:

store and manage the project’s codebase
create branches for features, fixes, and experiments
collaborate through pull requests and code reviews
track changes and maintain a clear project history
deploy code to different environments (dev, stage, production)

GitHub allows multiple people to work on the same project without overwriting each other’s work.

Good GitHub Practices

Read Terra’s Branch Strategy
Always create a new branch for each task or feature
Follow Terra’s branch naming convention (keyword--description--clickup-id)
Make sure you are working from the latest version of the branch
Read Terra’s guide to commit
Keep commits small, clear, and focused
Write meaningful commit messages that explain what and why
Push your changes regularly to avoid large, risky commits
Open pull requests early if you need feedback
Never work directly on main, stage, or dev
Make sure your branch is up to date before merging
Delete branches once they are merged and deployed

Keeping good GitHub habits helps the entire team collaborate smoothly and prevents conflicts, broken deploys, and lost work.

Knowledge Check

Test your understanding of this section

Loading questions...