22title : " 💪 Exercise"
33---
44
5- ## Step 0: Log in to the JupyterHub
5+ ## Step 0: Setup
6+
7+ ### Step 0a: Log in to JupyterHub
68
791 . ** 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
22241 . ** 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.
52711. **Double-click the GeoJSON file `seec.geojson`** to view it with the JupyterLab viewer.
53721. **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-
108971. ** Run the following commands in the terminal** :
10998
11099 ` ` ` bash
0 commit comments