Skip to content

[Phase 1] Initial Restructuring#504

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

[Phase 1] Initial Restructuring#504
folkwest wants to merge 2 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
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