Skip to content

Commit 10dbb10

Browse files
committed
Update module 1 setup instructions to match new notebook flow for gh-scoped-creds
1 parent e5f564c commit 10dbb10

File tree

1 file changed

+24
-35
lines changed

1 file changed

+24
-35
lines changed

modules/01-collaborating-in-jupyterhub/exercise.md

Lines changed: 24 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22
title: "💪 Exercise"
33
---
44

5-
## Step 0: Log in to the JupyterHub
5+
## Step 0: Setup
6+
7+
### Step 0a: Log in to JupyterHub
68

79
1. **Visit <https://hub.cryointhecloud.com>**.
810
You may want to bookmark this page!
@@ -17,7 +19,7 @@ title: "💪 Exercise"
1719
take a look!
1820

1921

20-
## Step 1: Create and clone a new repository for this workshop's exercises
22+
### Step 0b: Create and clone a new repository for this workshop's exercises
2123

2224
1. **Create a new repository in GitHub from our
2325
[workshop template repository](https://github.com/geojupyter/workshop-csdms2025-template)**.
@@ -43,12 +45,29 @@ title: "💪 Exercise"
4345
```
4446

4547

46-
## Step 2: Explore some example data
48+
### Step 0c: Set up GitHub authentication
49+
50+
In order to push changes from the JupyterHub to GitHub to save our work, you need
51+
credentials.
52+
Since the JupyterHub is a shared cloud service, saving credentials there can be
53+
dangerous.
54+
Therefore, we use a special tool,
55+
[`gh-scoped-creds`](https://github.com/jupyterhub/gh-scoped-creds),
56+
to limit this risk.
4757

48-
1. **Navigate to the newly cloned repository in the JupyterLab file browser** on the
58+
1. **Navigate to the newly cloned repository** in the JupyterLab file browser on the
4959
left panel.
5060
* If the left panel isn't open, click the topmost icon in the far left column.
51-
1. **Navigate to the `exercises/module-1` directory**.
61+
1. In the JupyterLab file browser, **open `00-START-HERE.ipynb`**.
62+
1. Follow the instructions in the Notebook.
63+
64+
This configuration is valid for 8 hours.
65+
If you need to refresh your access later, please re-do these steps.
66+
67+
68+
## Step 2: Explore some example data
69+
70+
1. **Navigate to the `exercises/module-1` directory** in the JupyterLab file browser.
5271
1. **Double-click the GeoJSON file `seec.geojson`** to view it with the JupyterLab viewer.
5372
1. **Right-click the same GeoJSON file `seec.geojson`, and select "JSON"** to view the raw
5473
contents of the file in a structured way.
@@ -75,36 +94,6 @@ We'll explore some of the latest examples of this progress soon.
7594

7695
## Step 4: Push our work to GitHub
7796

78-
### Step 4a: Set up authentication
79-
80-
In order to push changes from the JupyterHub, you need credentials.
81-
Since the JupyterHub is a shared cloud service, saving credentials there can be
82-
dangerous.
83-
Therefore, we use a special tool,
84-
[`gh-scoped-creds`](https://github.com/jupyterhub/gh-scoped-creds),
85-
to limit this risk.
86-
87-
1. **In the terminal, run the command**:
88-
89-
```bash
90-
gh-scoped-creds
91-
```
92-
93-
1. This will output a URL and an authorization code.
94-
**Visit the URL and input the code**.
95-
1. This will output another URL.
96-
* Visit that URL.
97-
* Click the "Configure" button.
98-
* Select your username from the list, and continue.
99-
* Select "Only select repositories", and then select `workshop-csdms2025-exercises`.
100-
* Click "Install".
101-
102-
This configuration is valid for 8 hours.
103-
If you need to refresh your access later, please re-do these steps.
104-
105-
106-
### Step 4b: Push!
107-
10897
1. **Run the following commands in the terminal**:
10998

11099
```bash

0 commit comments

Comments
 (0)