[Phase 1] Initial Restructuring#504
Open
folkwest wants to merge 2 commits into
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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