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
Commands
- Run the command
npx markdownlint-cli **/docs/*.mdto check for and report markdown errors - Run the script check-doc-links.ps1 to check for bad links
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
- Run the command
npx markdownlint-cli **/docs/*.mdto check for and report markdown errors - Run the script check-doc-links.ps1 to check for bad links
Converted and distributed by TomeVault — claim your Tome and manage your conversions.