How github/github-well-architected works
This repository maintains the GitHub Well-Architected Framework static site and content library. Authors contribute guidance across framework pillars and scenarios; the site presents that material through Hugo layouts and shared page components. The documented content-preprocessing workflow merges Markdown includes and adjusts relative links before Hugo builds or serves the site. The graph captures major content domains from the tree and the sampled preprocessing code; README documents local Hugo serving, but no deployment/runtime wiring was sampled.
Main entry points: library Framework library · scenarios Scenarios · includeMarkdown.js Markdown inclusion · adjust-hugo-links.js Link adjustment
Components 14
Framework content
- Framework library
content/library - Pillar guidance
content/library - Scenarios
content/library/scenarios - Migration guides
content/library/scenarios/migrations
Static site
- Hugo configuration
config - Page layouts
layouts - Browser assets
assets - Hugo site engine
Content preprocessing
- Markdown inclusion
src/markdown-includer/includeMarkdown.js - Link adjustment
src/resolve-hugo-links/adjust-hugo-links.js - Link depth reduction
src/resolve-hugo-links/reduce-link-depth.js - Processed content
Other components
- Content authors
- Site visitor
Connections 14
- Content authors → Framework library: contribute guidance
README.md - Framework library → Pillar guidance: organizes pillars
README.md - Framework library → Scenarios: includes scenarios
README.md - Scenarios → Migration guides: includes migration guides
- Framework library → Markdown inclusion: supplies Markdown
- Markdown inclusion → Processed content: merges includes
src/markdown-includer/includeMarkdown.js - Processed content → Link adjustment: supplies files
- Link adjustment → Processed content: adjusts links
src/resolve-hugo-links/adjust-hugo-links.js - Link depth reduction → Framework library: rewrites links
src/resolve-hugo-links/reduce-link-depth.js - Hugo configuration → Hugo site engine: configures site
- Page layouts → Hugo site engine: provides templates
- Browser assets → Hugo site engine: provides assets
- Hugo site engine → Site visitor: serves pages
README.md - Site visitor → Hugo site engine: requests pages
README.md