Skip to content

Commit

Permalink
minor updates in "browsing" episode
Browse files Browse the repository at this point in the history
  • Loading branch information
bast committed Sep 1, 2024
1 parent bd81c29 commit 675ba9a
Showing 1 changed file with 15 additions and 15 deletions.
30 changes: 15 additions & 15 deletions content/browsing.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,32 +17,32 @@ own changes in the next episode.
* See a real Git repository and understand what is inside of it.
* Understand how version control allows advanced inspection of a
repository.
* See how Git allows multiple people to collaborate easily.
* See the big picture instead of remembering a bunch of commands.
* See how Git allows multiple people to collaborate relatively easily.
* **See the big picture** instead of remembering a bunch of commands.
:::


## GitHub, VS Code, Command line, and more

We offer **three different paths** of how to do this exercise:
We offer **three different paths** for this exercise:
- **GitHub** (this is the one we will demonstrate on day 1)
- **VS Code** (if you prefer to follow along using an editor; we will
do this on day 2)
return to this on day 2)
- **Command line** (for people comfortable with the command line; you
will see more of this on day 2)

In the future we'll add more paths, for example Jupyter and RStudio
(contributions welcome!).
([contributions welcome!](https://github.com/coderefinery/git-intro/issues/458)).


## Creating a copy of the repository by "forking"

A {term}`repository` is a collection of files in one directory tracked
by git. A {term}`GitHub repository` is GitHub's copy, which adds
things like access control. Each GitHub repository is owned by a user
or organization, who controls what is in it.
or organization, who controls access.

First, we need to make our own copy of the exercise repository. This will
First, we need to make **our own copy** of the exercise repository. This will
become important later, when we make our own changes.

1. Go to the repository view on GitHub:
Expand All @@ -57,11 +57,11 @@ become important later, when we make our own changes.
:class: with-border
:::
1. You should shortly be redirected to your copy of the repository
**YOUR_USER_NAME/recipe-book**.
**USER/recipe-book**.

At all times you should be aware of if you looking at *your* repository
or the *CodeRefinery {term}`upstream`* repository.
* Your repository: https://github.com/**USERNAME**/recipe-book
* Your repository: https://github.com/**USER**/recipe-book
* CodeRefinery upstream repository: https://github.com/**cr-workshop-exercises**/recipe-book

:::::{tabs}
Expand Down Expand Up @@ -116,9 +116,9 @@ need to have forked the repository as described above.
Work on this by yourself or in your team.

:::{instructor-note}
Before starting the exercise session:
- Make sure you have shown how to fork the repository to own account
(above).
Before starting the exercise session show
how to fork the repository to own account
(above).
:::

:::{exercise} Exercise: Browsing an existing project (25 min)
Expand Down Expand Up @@ -225,7 +225,7 @@ We don't know how to do this without an extension. Try starting a terminal and u
::::

::::{group-tab} Command line
If you defined the `git graph` alias as in {doc}`configuration`, you
If you defined the `git graph` alias (shortcut) as in {doc}`configuration`, you
can view the network graph with:
```console
$ git graph
Expand Down Expand Up @@ -305,7 +305,7 @@ instance, including the context.

::::{group-tab} VS Code
If you use the "Search" magnifying class on the left sidebar, and
search for "Salt" it shows the occurrences in every file. You can
search for "salt" it shows the occurrences in every file. You can
click to see the usage in context.
::::

Expand Down Expand Up @@ -388,7 +388,7 @@ copy.

- Git allowed us to understand this simple project much better than we
could, if it was just a few files on our own computer.
- It was also very easy to share the project with the course.
- It was easy to share the project with the course.
- By forking the repository, we created our own copy. This is
important for the next episode, where we will make changes to
our copy.

0 comments on commit 675ba9a

Please sign in to comment.