Skip to content

Phase 6: Infrastructure cleanup and deployment #23

@kristopherjturner

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew 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