Skip to content

Update OHW26 documentation for CryoCloud migration - #388

Merged
abkfenris merged 3 commits into
sourcefrom
claude/cryocloud-jupyterhub-docs-1p3uil
Aug 21, 2026
Merged

Update OHW26 documentation for CryoCloud migration#388
abkfenris merged 3 commits into
sourcefrom
claude/cryocloud-jupyterhub-docs-1p3uil

Conversation

@abkfenris

Copy link
Copy Markdown
Member

This PR updates OceanHackWeek documentation to reflect the migration from the NMFS Openscapes JupyterHub to CryoCloud, a community JupyterHub infrastructure run by 2i2c.

Key changes:

  • JupyterHub preparation guide: Completely rewrote resources/prep/jupyterhub.md to document CryoCloud access, including:

    • New GitHub organization membership requirements (public visibility in ohw26-participants team)
    • Updated login flow and authorization process for nasa-cryo-prod
    • New Server Options interface for selecting environment and resource allocation
    • Updated hub URLs from nmfs-openscapes.2i2c.cloud to hub.cryointhecloud.com
    • Removed outdated Dask distributed computation section
    • Added guidance on continuing CryoCloud access after the event
  • New compute FAQ: Created ohw26/logistics/faq.md as a quick reference guide covering:

    • Pre-login GitHub setup requirements
    • Environment and RAM selection
    • Tutorial access via nbgitpuller links
    • Server shutdown procedures
    • Post-event CryoCloud access
  • Updated supporting documentation:

    • resources/prep/conda.md: Simplified to reference CryoCloud's Server Options page
    • ohw26/tutorials_getting_started.md and resources/tutorials/getting_started.md: Updated hub URLs
    • ohw26/logistics/index.md: Updated location (Bamfield Marine Sciences Centre), dates (Aug 24-28), and hub references
    • ohw26/logistics/getting_help.md: Updated Slack channel names to #ohw26_*
    • ohw26/tutorials-index/index.md: Simplified to reference schedule page and past years' tutorials
    • ohw26/projects/projects_thisyear.md: Cleared OHW25 projects, added placeholder for OHW26
  • Added CryoCloud screenshots: Six new images documenting the login and server startup process

  • Minor updates: Updated copyright year to 2026, fixed typos, and updated various references throughout

https://claude.ai/code/session_01VyVErsdwE67SC2NVW8UPxr

OHW26 uses CryoCloud (hub.cryointhecloud.com) rather than the retired
workshop.nmfs-openscapes.2i2c.cloud hub. CryoCloud has a different
onboarding path -- public GitHub org membership, authorizing
nasa-cryo-prod/2i2c, and choosing an Environment plus Resource
Allocation on the Server Options page -- none of which was documented.

Compute docs:
- Rewrite resources/prep/jupyterhub.md around CryoCloud: the GitHub
  membership prerequisite, the 2i2c authorization (including granting
  the oceanhackweek org), image and RAM selection, and shutting the
  server down. Six new screenshots.
- Add ohw26/logistics/faq.md as a short year-specific quick reference
  linking into that walkthrough.
- Point nbgitpuller links at the new hub and pin branch=OHW26.
- Drop the Dask Gateway section and the jupyter-image environment
  details, neither of which is verified against CryoCloud.
- Retarget the retired pilot.2i2c.org link to docs.2i2c.org.

ohw26/ was copied from ohw25/ with five pages left unedited, so this
also brings them to 2026: Slack channels (ohw25_* -> ohw26_*), the
Logistics venue and dates, the projects page, and the tutorials index
(lineup stripped in favour of the live schedule rather than restating
last year's sessions). Restores the OHW26 toctree, whose entries were
wrapped in HTML comments that Sphinx read as document names.

Sphinx build: 124 warnings vs 147 on source, no new warnings.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VyVErsdwE67SC2NVW8UPxr
@netlify

netlify Bot commented Aug 21, 2026

Copy link
Copy Markdown

Deploy Preview for oceanhackweek-preview ready!

Name Link
🔨 Latest commit 8fa319b
🔍 Latest deploy log https://app.netlify.com/projects/oceanhackweek-preview/deploys/6a88a621c854c00008c15c0d
😎 Deploy Preview https://deploy-preview-388--oceanhackweek-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

abkfenris and others added 2 commits August 21, 2026 12:20
c96bf02 removed the "Slack help groups" section from the OHW26 Getting
Help page, but three references to those groups survived in the prep and
organizing material that OHW26 links to:

- resources/prep/conda.md: the !pip install warning pointed at
  @help-infrastructure; now points at #ohw26_helpdesk, matching how
  ohw26/logistics/faq.md closes.
- resources/prep/github.md: asked people to post in #ohw23_helpdesk and
  tag @help-infrastructure; now #ohw26_helpdesk with no tag.
- resources/organizing/helpers.md: two links to
  ../logistics/getting_help.md#slack-help-groups, an anchor that no
  longer exists (and whose relative path was already wrong). Replaced
  with plain text.

Sphinx build: 122 warnings, down from 124, with the two slack-help-groups
xref warnings resolved and none added.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VyVErsdwE67SC2NVW8UPxr
@abkfenris
abkfenris merged commit cacf1f6 into source Aug 21, 2026
7 checks passed
@abkfenris
abkfenris deleted the claude/cryocloud-jupyterhub-docs-1p3uil branch August 21, 2026 19:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants