Skip to content

[Phase 1] Initial Restructuring#504

Open
folkwest wants to merge 10 commits into
srcfrom
restructure-phase1
Open

[Phase 1] Initial Restructuring#504
folkwest wants to merge 10 commits into
srcfrom
restructure-phase1

Conversation

@folkwest

@folkwest folkwest commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Pages that were consolidated (merged from multiple sources)
New page > Source pages merged
get-started.md > Extracted from start-here.md
scheduling-jobs.md > scheduling-jobs.md + checkpoint.md
gpus.md > gpu_start.md + nvidia_ngc.md + ollama_setup.md
scheduling-jobs.md > scheduling-jobs.md + monitoring-jobs.md
storage.md > gui.md + cli.md + boto3.md
getting-started.md > start.md + ood.md
interactive-apps.md > jupyter.md + vscode.md + matlab.md + rstudio.md
vscode.md > vscode.md + vsc-code-server.md + vsc-proxy-jump.md

New placeholder pages (didn't exist before)
New page > Purpose
gpus.md > H200-specific GPU content

All old pages are now in docs/_old/ with their original directory structure preserved:

docs/_old/compute/, docs/_old/contribute/, docs/_old/data-commons/, docs/_old/gpus/, docs/_old/hyak101/, docs/_old/klone/, docs/_old/lolo/, docs/_old/ood/, docs/_old/setup/, docs/_old/storage/, docs/_old/tillicum/, docs/_old/tools/
Plus the root-level files: account-activation.md, account-creation.md, FAQ.md, glossary.md, join-group.md, resources.md, setup.md, tutorial.md

The docs/ folder now only contains the new structure:
index.md
(home)
docs/getting-started/
docs/systems/
docs/guides/
docs/tutorials/
docs/resources/

Docusaurus config updated with exclude: ['_old/**'] so the old files won't be processed or create duplicate page conflicts.

Full New Structure
Home

Getting Started (shared)
├── Join a Group
├── Account Creation
├── Account Activation
└── SSH & Login
Systems
├── Klone (HPC)
│ ├── Get Started (login nodes, arbiter, hyakalloc)
│ ├── Storage (gscratch, quotas)
│ ├── Scheduling Jobs (accounts, partitions, checkpoint)
│ └── GPUs
├── Tillicum (GPU)
│ ├── Get Started (billing, QoS, project allocations)
│ ├── Storage (gpfs, project dirs)
│ ├── Scheduling Jobs (QoS model, no checkpoint)
│ └── GPUs (H200-specific)
├── Kopah (S3 Storage)
│ ├── Overview
│ └── Storage (GUI / CLI / boto3)
└── Lolo (Tape Archive)
├── Overview
└── Storage
Guides
├── Software Environments
│ ├── Modules (one page, with Klone vs Tillicum tabs/callouts)
│ ├── Conda & Python (one canonical page)
│ └── Containers (Apptainer)
├── Open OnDemand
│ ├── Getting Started
│ ├── Interactive Apps
│ └── Interactive Jobs
├── Data Transfer
│ ├── Globus
│ ├── Cyberduck
│ └── SCP & Rsync
└── Applications
├── Jupyter
├── VS Code
├── R & RStudio
└── MATLAB
Tutorials
├── Linux Basics
├── Slurm
├── Containers
└── Jupyter Notebooks
Resources
├── FAQ
├── Glossary
├── Contribution Guide
└── Data Commons

@folkwest folkwest requested a review from finchnSNPs June 16, 2026 20:07
@folkwest

folkwest commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator Author

List of Changes:

  • gpus.md > gpu_start.md + nvidia_ngc.md + ollama_setup.md -> nvidia_ngc.md is a part of the containers page. ollama_setup.md is under tools & software section.
  • gui.md + cli.md + boto3.md have been separated out
  • Interactive apps (under OOD) have been separated out
  • System architecture pages have been added back in
  • VS Code section has been separated out
  • Tutorials have been removed from Docs, specific cards in Learn link to the tutorial pages
  • Tabs have been added to the Modules page to change the content of the page (see below). The tabs have been configured so that one tab selection changes all of the tab selections on the page (for consistency)
Screenshot 2026-07-09 at 9 33 25 AM

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.

1 participant