Skip to content

Commit

Permalink
Merge pull request #15 from abnerbog/main
Browse files Browse the repository at this point in the history
Update course_guide_learners_static.md
  • Loading branch information
lindsayplatt authored May 24, 2024
2 parents 82757cc + 947c474 commit 1621447
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 5 deletions.
10 changes: 6 additions & 4 deletions .github/issues_to_create/issue_03.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,18 @@ The next step in our workflow is to clone your fork. This creates a local copy o
----
**Action:** Clone this repo!

![image](https://github.com/CUAHSI/learning-gitflows-template/assets/28936967/53cd6b35-03ec-45d5-bd64-8b889162efd9)

1. Open the GitHub page for your fork, e.g. `https://github.com/[username]/learning-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 green `Code` button that has a drop down arrow. Again, make sure you are ***on your fork***. This means that you see `[username]/learning-gitflows-[username]` at the top of the page with `forked from [org]/learning-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](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and [these instructions to add the SSH key to your GitHub account](https://help.github.com/en/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account). When you come back to the page, you should have the SSH option.

![image](https://github.com/CUAHSI/learning-gitflows-template/assets/13220910/03273273-ebc7-4d7f-955c-dfaedf68edaa)

4. Open Git Bash on your computer.
5. Change the working directory ([use `cd`](https://stackoverflow.com/questions/17753986/how-to-change-directory-using-windows-command-line)) 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.
6. Type `git clone [insert URL]` and hit enter, e.g. `git clone [email protected]:[username]/learning-gitflows-[username].git`. Note that you cannot CTRL+V to paste into Git Bash. Right click and choose paste instead.
7. 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.
4. Open the command line (Windows --> Command Prompt, Mac or Linux --> Terminal). Note that 'Git Bash' is also used to refer to the command line in this training.
5. Change the working directory ([use `cd`](https://stackoverflow.com/questions/17753986/how-to-change-directory-using-windows-command-line)) to the location where you would like to create the cloned directory (see step 1 in snapshot of command prompt). I would recommend creating a folder somewhere in your D drive to put GitHub projects.
6. Type `git clone [insert URL]` and hit enter (step 2 in snapshot of command prompt), e.g. `git clone [email protected]:[username]/learning-gitflows-[username].git`. Note that you cannot CTRL+V to paste into Git Bash. Right click and choose paste instead.
7. 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 (step 3 and 4 in snapshot of command prompt; use the command `dir` to inspect the folder contents).
8. While in the folder, run the command 'git config pull.rebase false'. This will keep a confusing error message from arising later on.

You have now successfully cloned your fork! Close this issue and move on to the next one.
22 changes: 21 additions & 1 deletion course_guide_learners_static.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,27 @@ Congratulations! You've made your own copy of the main repository. Now on to the
<details>
<summary><h2>Create a local copy (clone)</h2></summary>

INSERT ISSUE 3!
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!

![image](https://github.com/CUAHSI/learning-gitflows-template/assets/28936967/53cd6b35-03ec-45d5-bd64-8b889162efd9)

1. Open the GitHub page for your fork, e.g. `https://github.com/[username]/learning-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 green `Code` button that has a drop down arrow. Again, make sure you are ***on your fork***. This means that you see `[username]/learning-gitflows-[username]` at the top of the page with `forked from [org]/learning-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](https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and [these instructions to add the SSH key to your GitHub account](https://help.github.com/en/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account). When you come back to the page, you should have the SSH option.

![image](https://github.com/CUAHSI/learning-gitflows-template/assets/13220910/03273273-ebc7-4d7f-955c-dfaedf68edaa)

4. Open the command line (Windows --> Command Prompt, Mac or Linux --> Terminal). Note that 'Git Bash' is also used to refer to the command line in this training.
5. Change the working directory ([use `cd`](https://stackoverflow.com/questions/17753986/how-to-change-directory-using-windows-command-line)) to the location where you would like to create the cloned directory (see step 1 in snapshot of command prompt). I would recommend creating a folder somewhere in your D drive to put GitHub projects.
6. Type `git clone [insert URL]` and hit enter (step 2 in snapshot of command prompt), e.g. `git clone [email protected]:[username]/learning-gitflows-[username].git`. Note that you cannot CTRL+V to paste into Git Bash. Right click and choose paste instead.
7. 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 (step 3 and 4 in snapshot of command prompt; use the command `dir` to inspect the folder contents).
8. While in the folder, run the command 'git config pull.rebase false'. This will keep a confusing error message from arising later on.

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


</details>

Expand Down

0 comments on commit 1621447

Please sign in to comment.