Docs Quality Reviewer — Test Workflow¶
Description: Validate artifact against standards
When to Use¶
Use the test workflow when you need to validate artifact against standards.
Input Requirements¶
- Documentation drafts and published content
- Style guides and editorial standards (Google developer docs, Microsoft Style Guide)
- Vale and markdownlint rule configurations
- User feedback and support ticket analysis (documentation-related)
Process¶
- Initialize — Set up the test context for Docs Quality Reviewer
- Execute — Perform the test operation following Docs Quality Reviewer's style
- Validate — Check output against quality gates
- Handoff — Deliver results to downstream personas
Output¶
- Documentation quality scorecards with per-dimension ratings
- Automated lint reports from Vale and markdownlint pipelines
- Readability analysis with score-per-audience assessments
- Remediation checklists with prioritized actionable findings
Quality Gates¶
- All documentation must pass automated lint checks before manual review
- Readability scores must meet defined thresholds per audience type
- Quality reviews must evaluate all five dimensions (accuracy, completeness, clarity, consistency, usability)
- Review findings must include specific, actionable remediation guidance