Creating a Fork - Carleton-SRCL/SPOT GitHub Wiki

Creating a fork is simple:

  1. Ensure you have a GitHub account, login, and then navigate to https://github.com/Carleton-SRCL/SPOT.
  2. On the top right of the repository, there is an option to "fork", as shown:

Git Fork

  1. After clicking the icon, a fork will be created. This will create a copy of the repository on your GitHub account. You can now make modifications to the software without risking the integrity of the main repository.

  2. Next, your fork should have a name that clearly identifies it. On the GitHub website, navigate to your new repository. Go to "Settings", and under "Options" there is an option to rename the repository. We recommend "[FirstnameLastname]-SPOT":

Git Fork Name

  1. After renaming your fork, it's time to get it onto your personal computer (or the lab ground station computer). Install GitHub Desktop, login to your account, and navigate to File -> Clone Repository.

image

  1. In the clone dialog box, input the URL for your fork and then indicate the folder it should be placed inside. Typically, the default works (note, in the image below I have already create my fork, and so there is an error message indicating I can't write to the folder... this should not appear when cloning your fork):

image

And that's it! You've created your fork and can now work from it.