USGS-R/ds-gitflows-ecoenen

Create a local copy (clone)

Opened this issue · 0 comments

The next step in our workflow is to clone your fork. This creates a local copy of the repository that is specific to your user on GitHub. The local copy is where you will make changes to the codebase.


Action: Clone this repo!

  1. Open the GitHub page for your fork, e.g. https://github.com/[username]/ds-gitflows-[username]. A navigation note: from your fork, you can easily navigate back to the canonical repository by clicking the link next to "forked from" at the top, just below your forked repository name. From the canonical repo page, you can get back to your fork by clicking the fork button on the canonical repo and choosing your existing fork from the list.
  2. Click the Clone or download button. Again, make sure you are on your fork. This means that you see [username]/ds-gitflows-[username] at the top of the page with forked from USGS-R/ds-gitflows-[username] underneath.
  3. Copy the SSH address, not the HTTPS one (see image below). We should have already set up your SSH keys, but if not, follow these instructions to generate an SSH key and these instructions to add the SSH key to your GitHub account. When you come back to the page, you should have the SSH option.

image

  1. Open Git Bash on your computer.
  2. Change the working directory (use cd) to the location where you would like to create the cloned directory. I would recommend creating a folder somewhere in your D drive to put GitHub projects.
  3. Type git clone [insert URL] and hit enter, e.g. git clone git@github.com:[username]/ds-gitflows-[username].git. Note that you cannot CTRL+V to paste into Git Bash. Right click and choose paste instead.
  4. A new folder with the same name as the repository is now available in your working directory. In the folder, you will find the same files and file structure that you can see on GitHub.

You have now successfully cloned your fork! Close this issue and move on to the next one.