Skip to content

Reduce site storage - #1256

Draft
felker wants to merge 2 commits into
mainfrom
feature/optimize-size
Draft

Reduce site storage #1256
felker wants to merge 2 commits into
mainfrom
feature/optimize-size

Conversation

@felker

@felker felker commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Delete 48 files (~29 MB) that ship into every deploy but are not reachable from any page:

  • IO-optimization_mcpheeters.pdf (10.4 MB): the data-policy page links the external alcf.anl.gov copy; this local duplicate was never linked
  • 45 orphaned images/GIFs/EPS verified unreferenced by grepping every basename across docs/, overrides/, includes/, scripts/, and mkdocs.yml (largest clusters: old GitLab CI screenshots in polaris/compiling-and-linking/files/, Docker/Singularity walkthrough GIFs in services/files/, unused ACDC and project-management sets)
  • aps_report HTML (0.24 MB) whose only link was already commented out
  • advisor-report_amr-wind.html (5.7 MB): referenced, so the advisor.md link is stubbed out with a comment until the report is hosted externally, following the aps.md precedent

Enable navigation.prune (mkdocs.yml): the 69 KB sidebar nav was embedded byte-identically in all ~250 pages (~17 MB of built HTML, rewritten on every deploy that touches the nav). Collapsed sections now navigate to their first page instead of expanding in place; navigation.instant keeps this fast.

docs/ 81 -> 53 MB; built site/ 115 -> 73 MB

Delete 48 files (~29 MB) that ship into every deploy but are not
reachable from any page:
- IO-optimization_mcpheeters.pdf (10.4 MB): the data-policy page links
  the external alcf.anl.gov copy; this local duplicate was never linked
- 45 orphaned images/GIFs/EPS verified unreferenced by grepping every
  basename across docs/, overrides/, includes/, scripts/, and mkdocs.yml
  (largest clusters: old GitLab CI screenshots in
  polaris/compiling-and-linking/files/, Docker/Singularity walkthrough
  GIFs in services/files/, unused ACDC and project-management sets)
- aps_report HTML (0.24 MB) whose only link was already commented out
- advisor-report_amr-wind.html (5.7 MB): referenced, so the advisor.md
  link is stubbed out with a comment until the report is hosted
  externally, following the aps.md precedent

Enable navigation.prune (mkdocs.yml): the 69 KB sidebar nav was
embedded byte-identically in all ~250 pages (~17 MB of built HTML,
rewritten on every deploy that touches the nav). Collapsed sections now
navigate to their first page instead of expanding in place;
navigation.instant keeps this fast.

docs/ 81 -> 53 MB; built site/ 115 -> 73 MB. Strict build and inbound
link validation pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ATF2kcyeGMrCwjtzxdDjNC
@felker felker added external sites Issues on alcf.anl.gov, etc. external webpages closely linked to docs.alcf.anl.gov. General UX organization where to place/split/replicate .md content; nav menu dropdown and folder hierarchy labels Aug 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external sites Issues on alcf.anl.gov, etc. external webpages closely linked to docs.alcf.anl.gov. General UX organization where to place/split/replicate .md content; nav menu dropdown and folder hierarchy

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant