uwhackweek · aaarendt · Mar 15, 2024 · Mar 15, 2024 · Mar 15, 2024 · Mar 15, 2024
diff --git a/book/_toc.yml b/book/_toc.yml
@@ -5,7 +5,6 @@ format: jb-book
 parts:
 - caption: Details
   chapters:
-    - file: application
     - file: logistics
     - title: Schedule
       url: https://uwhackweek.github.io/jupyterbook-template/index.html?jump_to=schedule
@@ -14,15 +13,9 @@ parts:
     - file: CoC
 - caption: Preparation
   chapters:
-    - file: preliminary/checklist_index
-      sections:
-      - file: preliminary/checklist/github
-      - file: preliminary/checklist/jupyterhub
-      - file: preliminary/checklist/git
-      - file: preliminary/checklist/earthdata
-    - file: preliminary/skills_refresher_index
-      sections:
-        - file: preliminary/skills-refresher/swc
+    - file: preliminary/index
+    - file: preliminary/checklist
+    - file: preliminary/git
 - caption: Tutorials
   chapters:
     - file: tutorials/index

diff --git a/book/application.md b/book/application.md
diff --git a/book/img/CoC.png b/book/img/CoC.png
diff --git a/book/img/belonging.png b/book/img/belonging.png
diff --git a/book/img/clone-result.png b/book/img/clone-result.png
diff --git a/book/img/clone.png b/book/img/clone.png
diff --git a/book/img/co-creation.png b/book/img/co-creation.png
diff --git a/book/img/earthdata-login.png b/book/img/earthdata-login.png
diff --git a/book/img/education.png b/book/img/education.png
diff --git a/book/img/git-fork-clone-update.png b/book/img/git-fork-clone-update.png
diff --git a/book/img/git-linear-flow-2.png b/book/img/git-linear-flow-2.png
diff --git a/book/img/git-repo-structure.png b/book/img/git-repo-structure.png
diff --git a/book/img/github-clone-url.png b/book/img/github-clone-url.png
diff --git a/book/img/github-fork.png b/book/img/github-fork.png
diff --git a/book/img/github-signup.png b/book/img/github-signup.png
diff --git a/book/img/github-token.png b/book/img/github-token.png
diff --git a/book/img/github_whw_repos_image.png b/book/img/github_whw_repos_image.png
diff --git a/book/img/hackweek-mission.png b/book/img/hackweek-mission.png
diff --git a/book/img/hub-logout-button.png b/book/img/hub-logout-button.png
diff --git a/book/img/interactivity.png b/book/img/interactivity.png
diff --git a/book/img/jupyter-terminal.png b/book/img/jupyter-terminal.png
diff --git a/book/img/jupyterhub-authentication.png b/book/img/jupyterhub-authentication.png
diff --git a/book/img/jupyterhub-connectivity.png b/book/img/jupyterhub-connectivity.png
diff --git a/book/img/jupyterhub-overview.png b/book/img/jupyterhub-overview.png
diff --git a/book/img/jupyterhub-upload.png b/book/img/jupyterhub-upload.png
diff --git a/book/img/jupyterhub-website-folder.png b/book/img/jupyterhub-website-folder.png
diff --git a/book/img/jupyterlab-git.jpg b/book/img/jupyterlab-git.jpg
diff --git a/book/img/jupyterlab.png b/book/img/jupyterlab.png
diff --git a/book/img/networking.png b/book/img/networking.png
diff --git a/book/img/pangeo-image-select.png b/book/img/pangeo-image-select.png
diff --git a/book/img/pangeo-opening.png b/book/img/pangeo-opening.png
diff --git a/book/img/pangeo-server-starting.png b/book/img/pangeo-server-starting.png
diff --git a/book/img/participant-selection.png b/book/img/participant-selection.png
diff --git a/book/img/people-github.png b/book/img/people-github.png
diff --git a/book/img/private-github.png b/book/img/private-github.png
diff --git a/book/img/projects.png b/book/img/projects.png
diff --git a/book/img/public-github.png b/book/img/public-github.png
diff --git a/book/img/repos.png b/book/img/repos.png
diff --git a/book/img/terminal-button.png b/book/img/terminal-button.png
diff --git a/book/img/terminal-clone.png b/book/img/terminal-clone.png
diff --git a/book/img/terminal.png b/book/img/terminal.png
diff --git a/book/preliminary/checklist_index.md → book/preliminary/checklist.md b/book/preliminary/checklist_index.md → book/preliminary/checklist.md
@@ -42,22 +42,32 @@ the week.
 ### EarthData Login
 
 We'll have you download some data from NSIDC for your tutorials and projects.
-Visit our [Earthdata](checklist/earthdata.md) page to learn how to access and Earthdata
-login account if you don't already have one!
+Visit the [Earthdata](https://www.earthdata.nasa.gov/eosdis/science-system-description/eosdis-components/earthdata-login)
+help page and learn how to register, access, and login if you don't already have
+an account!
 
 ### GitHub Account
 
 Everyone attending {{ hackweek }} will require obtaining a GitHub account.
-Visit our [GitHub instruction page](checklist/github.md) to learn how!
+Visit [the GitHub help pages](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github)
+if you are in need for an account!
 
+(accessing-jupyterhub)=
 ### JupyterHub
 
-We will offer all tutorials within the Jupyter Hub computing environment.
-Visit our [Introduction to Jupyter Hub](checklist/jupyterhub.md) page to learn more!
+We will offer all tutorials based on a JupyterHub environment. Please visit the
+[Project Pythia Foundation Skills](https://foundations.projectpythia.org/foundations/getting-started-jupyter.html)
+to learn more about the components of project Jupyter.
 
-### Git
+Specifically for the event, we will be using [CryoCloud](https://book.cryointhecloud.com/intro.html).
+To get started, please see the [onboarding instructions](https://book.cryointhecloud.com/content/Getting_Started.html)
+to gain access.
 
-All content of the hackweek will be shared via GitHub and interacting with the
-website will be done via the `git` command.
-Visit [Setting up the `git` command](checklist/git.md) to learn how to configure that!
+Optional setup after you are logged in CryoCloud:
+* Earthdata authentication to automate data downloads:
+  [Configure a netrc file](https://wiki.earthdata.nasa.gov/display/EL/How+To+Access+Data+With+cURL+And+Wget)
+* Git authentication:
 
+  All content of the hackweek will be shared via GitHub and interacting with the
+  website will be done via the `git` command. See our {ref}`setting-up-git`
+  to configure your access.
diff --git a/book/preliminary/checklist/earthdata.md b/book/preliminary/checklist/earthdata.md
diff --git a/book/preliminary/checklist/github.md b/book/preliminary/checklist/github.md
diff --git a/book/preliminary/checklist/jupyterhub.md b/book/preliminary/checklist/jupyterhub.md
diff --git a/book/preliminary/checklist/git.md → book/preliminary/git.md b/book/preliminary/checklist/git.md → book/preliminary/git.md
@@ -1,4 +1,4 @@
-# Git
+# Setting up `git`
 
 ## What is Git?
 
@@ -14,7 +14,7 @@ You are not required to know Git in advance of this event, but come prepared to
 
 Below are instructions to get you setup with `git` on the {{hackweek}} hackweek
 JupyterHub. These are only basic instructions to get started. See the
-[Software Carpentry Git](http://swcarpentry.github.io/git-novice/02-setup/index.html)
+[Software Carpentry Git](https://swcarpentry.github.io/git-novice/index.html)
 instructions for a more thorough explanation and background information.
 
 ### 1. Login to JupyterHub
@@ -23,7 +23,7 @@ Go to {{ jupyterhub_url }}. See also our JupyterHub documentation: {ref}`accessi
 ### 2. Open a Terminal
 Choose the 'Terminal' from the 'Other' options in the 'Launcher' tab.
 
-![jupyterlab](../../img/jupyter-terminal.png)
+![jupyterlab](../img/jupyter-terminal.png)
 
 ### 3. Configure basic `git` information
 Set your username and email address. The email address should be the same
@@ -45,7 +45,7 @@ git config --global credential.helper store
 
 The third line is a configuration option that needs to be done with a first time
 setup. It specifies the strategy on how git will apply changes you pull from
-a remote git repository. 
+a remote git repository.
 More on strategies is [described here.](http://git-scm.com/book/en/v2/Git-Branching-Rebasing)
 
 The last line of the config will store your GitHub credentials and will save
@@ -73,10 +73,12 @@ However, a better, more secure practice is to use a GitHub Personal Access Token
 more customizable permissions and can be revoked without affecting your main GitHub user
 account password.
 
-Take a moment to work through the instructions on the [GitHub personal access tokens](https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/creating-a-personal-access-token) page. For this hackweek, you need to check the **repo**, **admin:org**, and **workflow** scope.
+Take a moment to work through the instructions on the
+[GitHub personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic)
+page. For this hackweek, you need to check the **repo**, **admin:org**, and **workflow** scope.
 
 Screenshot from github.com setting up the token:
-![github-token](../../img/github-token.png)
+![github-token](../img/github-token.png)
 
 Once you have created your token, be sure to save it on your computer in case
 you need to re-authenticate again. The token will give you access to your
@@ -89,7 +91,7 @@ terminal on the JupyterHub. where you will be prompted for your GitHub username
 and the token.
 
 ```shell
-git clone {{github_org_url}}.github_setup_check.git
+    git clone {{ github_org_url }}/github_setup_check.git
 ```
 
 Since this is the first time you are interacting from the JupyterHub with GitHub,

diff --git a/book/preliminary/skills_refresher_index.md → book/preliminary/index.md b/book/preliminary/skills_refresher_index.md → book/preliminary/index.md
@@ -1,6 +1,13 @@
-# Skills Refresher
+# What to Expect 
 
-Our hackweeks focus on applied, hands-on learning, with participants engaging in extended periods of small-group work. Our tutorials are designed to offer a broad snapshot of data science tools to support your applied investigations. Due to the relatively short duration of our events, we are not able to provide comprehensive, in-depth training in fundamental tools. Rather, our goal is to inform you about the types of tools we think are best suited to working with your datasets, leaving details of implementation to be supported through peer-learning and office hours.
+Our hackweeks focus on applied, hands-on learning, with participants engaging in
+extended periods of small-group work. Our tutorials are designed to offer a broad
+snapshot of data science tools to support your applied investigations. Due to the
+relatively short duration of our events, we are not able to provide comprehensive,
+in-depth training in fundamental tools. Rather, our goal is to inform you about
+the types of tools we think are best suited to working with your datasets,
+leaving details of implementation to be supported through peer-learning and
+office hours.
 
 ## Typical Workflows and Tools
 
@@ -26,13 +33,10 @@ bit less time for applied group work. If you are already proficient in a lot of
 tools you may find you can dedicate more energy to applied project work, which
 we support through facilitated group activities.
 
-## Software Carpentry Session
+## Prerequisites
 
-We strongly suggest that participants who are just beginning to learn Python and
-collaborative data science tools to complete our
-recorded ([Software Carpentry Training](./skills-refresher/swc)) in advance of the hackweek. You
-may choose whichever topics you'd like to brush up on or learn.
-
-## Project Pythia
-
-Another excellent resource for training and skills development is the [Project Pythia](https://projectpythia.org/) organization. Their lessons and galleries are developed specifically for the geoscience community. For a good skills refesher, we encourage you to work through their [Pythia Foundations](https://foundations.projectpythia.org/landing-page.html) notebooks.
+All tutorials and project work will assume participants are familiar with Python-based
+computing in the geosciences as described on the 
+[Pythia Foundations](https://foundations.projectpythia.org/landing-page.html) website. 
+ We can provide resources to participants wishing to brush up on their skills before
+an event, however we will not be teaching these core concepts during the hackweek.