@@ -137,6 +137,7 @@ a workspace on a server (e.g., JupyterHub).
137
137
The other copy is typically stored in a repository hosting service (e.g., GitHub), where
138
138
we can easily share it with our collaborators.
139
139
This copy is commonly referred to as \index{repository!remote} the ** remote repository** .
140
+ \index{repository|see{version control}}
140
141
141
142
``` {r vc1-no-changes, fig.cap = 'Schematic of local and remote version control repositories.', fig.retina = 2, out.width="100%"}
142
143
image_read("img/version-control/vc1-no-changes.png") |>
@@ -200,10 +201,10 @@ image_read("img/version-control/vc2-changes.png") |>
200
201
```
201
202
202
203
Once you reach a point that you want Git to keep a record
203
- of the current version of your work, you need to commit
204
+ of the current version of your work, you need to ** commit** \index{git!commit}
204
205
(i.e., snapshot) your changes. A prerequisite to this is telling Git which
205
206
files should be included in that snapshot. We call this step ** adding** the
206
- files to the ** staging area** . \index{git!add, staging area}
207
+ files to the ** staging area** . \index{git!add, staging area}\index{staging area|see{git}}
207
208
Note that the staging area is not a real physical location on your computer;
208
209
it is instead a conceptual placeholder for these files until they are committed.
209
210
The benefit of the Git version control system using a staging area is that you
@@ -309,7 +310,7 @@ Repositories can be set up with a variety of configurations, including a name,
309
310
optional description, and the inclusion (or not) of several template files.
310
311
One of the most important configuration items to choose is the visibility to the outside world,
311
312
either public or private. * Public* repositories \index{repository!public} can be viewed by anyone.
312
- * Private* repositories can be viewed by only you. Both public and private repositories
313
+ * Private* repositories \index{repository!private} can be viewed by only you. Both public and private repositories
313
314
are only editable by you, but you can change that by giving access to other collaborators.
314
315
315
316
To get started with a * public* repository having a template ` README.md ` file, take the
@@ -530,9 +531,6 @@ image_read("img/version-control/generate-pat_03.png")
530
531
531
532
### Cloning a repository using Jupyter
532
533
533
- <!-- Now that we have everything we need for authentication,
534
- the next step is -->
535
-
536
534
* Cloning* a \index{git!clone} remote repository from GitHub
537
535
to create a local repository results in a
538
536
copy that knows where it was obtained from so that it knows where to send/receive
0 commit comments