How microsoftdocs/cloud-adoption-framework works
Project type and purpose
• This is a static documentation site (Microsoft Cloud Adoption Framework) built with markdown sources, templates, and configuration, then processed through a build pipeline to produce a published website.
File structure
• Top‐level directories:
• docs/ ← All markdown content, organized by topic/scenario
• includes/ ← Reusable content fragments
• templates/ ← Scenario‐ and page‐level markdown templates
• .docutune/ ← Configuration and data for DocuTune (content linting/score tool)
• Configuration files:
• docfx.json ← DocFX static‐site generator config (under docs/)
• .openpublishing.*.json ← Publishing pipeline settings
• cspell*.json ← Spell‐checker settings
• azure-pipelines.yml ← Azure DevOps build & publish pipeline
• .github/workflows/*.yml ← GitHub Actions workflows (e.g., stale issue cleanup)
• Templates & data:
• .docutune/config, /data, /dictionaries ← DocuTune content quality engine
• templates/ ← Base markdown templates for new scenarios
README for additional insights
• The README only specifies the Code of Conduct; no architectural doc is present, so we infer architecture from folder names and config files.
Detail
• Break each major piece into subcomponents (e.g., under Build: DocuTune config/data/dictionaries; under Hosting: static files + redirection JSON).
• Tool interactions (spell check before build, content score gating, template rendering).