Remotes - iToto/developmentCycle GitHub Wiki

Distributed VCS

Git is a distributed version control system. This means a few things.

  1. When cloning the repository you will have the entire repository’s history available on your local machine
  2. All work you do on your local copy of the repository remain local. This includes commits, branhches and tags.
  3. Every clone of the repository can behave as the official source or destination of changes. This means developers can share commits with each other without involving the actual ‘upstream’ git repository.

Github as our host

Github is our host for most of our projects. We have repositories listed under the Mira Geoscience organization (some are public, others private). These repositories are to be considered our ‘official’ sources. Release builds will come from here.

Forks

Github lets you create what are called forks. A fork gives developers their own online place to store their code changes. This means you can store your various branches on a server without clogging up the primary repository with branches.

When pushing your new commits, you should do so to your fork and not to the Mira Geoscience remote.

Pull Requests

You can find information on pull requests here.

Terminology

In this wiki a few names are used for certain remotes.

  • Origin refers to your personal fork. This is where you’re going to be pushing to day to day.
  • Upstream refers to the source of your fork. Probably a MiraGeoscience repository. You will be sending pull requests here and merging periodically to get the latest changes.
⚠️ **GitHub.com Fallback** ⚠️