Skip to content

Phase 6: Infrastructure cleanup and deployment #23

Description

@kristopherjturner

Parent Epic: #3

Description

Rename referrence/ to archive/, update mkdocs.yml with the full nav tree, and update README.md with repo description and build instructions.

Tasks

  • Rename referrence/ to archive/ via git mv referrence archive
    • Preserve all old materials (do not delete)
    • Old PowerPoints stay archived for reference
    • Old delivery guides stay archived for reference
  • Update mkdocs.yml with complete nav tree
    • Add full nav entries for all 11 modules
    • Add nav entries for delivery guide, labs, presentations
    • Verify admonition extensions are configured
    • Add search plugin if not present
    • Test with mkdocs serve
  • Update README.md
    • Repo purpose and description
    • Training curriculum overview
    • Build instructions (mkdocs serve, mkdocs build)
    • Link to CONTRIBUTING.md
    • Link to deployed site

Verification

  • Run mkdocs serve locally -- all pages render
  • Verify every nav entry has a corresponding .md file
  • Verify no broken internal links
  • Push to main and verify GitHub Pages deployment

Acceptance Criteria

  • referrence/ renamed to archive/
  • mkdocs.yml nav covers all docs
  • README.md is updated
  • Site builds and deploys successfully

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    ado-trackedIssue has a linked ADO work itemenhancementNew feature or requestphase-6Phase 6: Infrastructure & Cleanup

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions