Feature Review
Prerquisites
- •markdownlint is installed and can be called via
npx markdownlint-cli
When to use this skill
Use this skill when the user wants to check whether documentation fits required criteria.
Process inputs
- •An existing document
- •Optionally, a focus to review, such as a particular section or aspect
Process outputs
- •A report on the document's adherence to guidelines
- •Suggested edits to make a document more compliant
How to review the feature document
- •Read the provided document
- •Check for stylistic consistency, grammar, plain English and legibility
- •Check for relevance to the subject matter
- •Check for correctness compared to current implementation / goals
- •Check for adherence to the checklist
- •Check for adherence to the template
- •Use
npx markdownlint-cli **/*.mdto check for and report markdown errors - •Use check-doc-links.ps1 to check for bad links