Athas Boilerplate

Migration Complete Checklist

internal

Checklist for declaring docs migration complete and entering maintenance mode.

Completion criteria

  1. Canonical topics are present in /docs or /internal with audience tags.
  2. Legacy markdown copies are either pointer stubs or intentionally retained with rationale.
  3. docs/README.md quick links prioritize canonical Fumadocs pages.
  4. Roadmap and migration status are synchronized.
  5. Docs app build/typecheck pass on main.

Maintenance mode rules

  • New docs should start in Fumadocs collections first.
  • Legacy docs/ markdown should only host roadmap/ADRs or pointer stubs.
  • Any new legacy long-form doc must include a reason and migration plan.

Audit cadence

  • Weekly: check for new long-form legacy pages without canonical mapping.
  • Sprint close: ensure roadmap docs entries reflect migration status.

On this page