Skip to content

Teaching Partner quality audit

PowerAdvice must match or exceed the Teaching Partner documentation quality bar before AD-376 can close.

  • Docs OS content audit: npm run docs:poweradvice:audit reports ok: true, sections: 8, screenshots: 8.
  • Docs OS report: npm run docs:report reports the cms-astro profile, the docs-site path, the cms site, and all eight maintained CMS routes.
  • Docs OS verification: npm run docs:verify passes build, route, frontmatter, image, link, and manifest checks.
  • UAT deployment: PR #931 merged at 80bd2d26a95261fd653a781d643b4c3dd3cededb; Deploy Docs UAT run 30518311967 succeeded; https://docs-uat.poweradvice.com/ returns HTTP 200 with the title PowerAdvice CMS documentation | PowerAdvice CMS Docs.
  • Audience source map: Tory and LeeAnn source audit maps Gmail, Google Docs, and PostHog evidence to maintained documentation coverage.
  • Design standard: Docs design standard defines screenshot, callout, task-card, decision, and recovery standards.

The remaining parent acceptance work is tracked in the child issues named below. This page is the maintained audit record; it should be updated with final runtime, screenshot, Access, and update-route receipts before AD-376 closes.

Rubric item Current Docs OS evidence
Four-part information architecture Getting Started, Guides, Reference, Troubleshooting are present.
Every visible CMS section mapped See CMS inventory.
Workflow pages include purpose, prerequisites, steps, resulting state, permissions, failures, recovery npm run docs:poweradvice:audit checks every required guide page for the required operator sections.
Authenticated screenshots show workflow states Manifest tracks section-level workflow screenshots; final authenticated UAT/staging capture receipt remains owned by AD-379.
Deterministic non-production synthetic data Required by screenshot policy; final authenticated capture receipt remains owned by AD-379.
Screenshot manifest has no missing/orphaned/stale assets Enforced by npm run docs:screenshots:check.
No production personal data or secrets Enforced by screenshot policy and review.
Links, images, frontmatter, navigation, builds pass Enforced by npm run docs:verify and npm run docs:poweradvice:audit.
CMS Help links resolve to the appropriate environment UAT wiring is present through PUBLIC_DOCS_URL; final runtime Help-link receipts across required environments remain owned by AD-380.
Access challenge and authenticated route smoke pass Final docs Access challenge and authenticated route receipts remain owned by AD-380.
Docs deployment is revision-locked to application commit UAT deployment receipt is recorded above; final revision-lock receipt across required environments remains owned by AD-380.
Parent and Cursor update routes both pass Required before AD-376 close; no additional platform work is owned from this PowerAdvice audit page.
Side-by-side audit records Teaching Partner parity This page records the PowerAdvice parity audit and points failed/unproven runtime items to AD-379 and AD-380 before AD-376 close.