As part of providing guidance for how to use the Doc Metrics, I found myself writing instructions that should probably, ultimately, be part of the Documentation Toolkit:
- Shorten a page
- Improve page structure
- Improve page findability
- Improve content relevance
- Assess code samples
- Assess links to code
These pieces of content are basically checklists that, in some cases, link to the doc templates in the Toolkit as a reference for how to assess page structure, page contents, etc. These instructions should probably be integrated into the review checklists, or somehow maintained as part of the Toolkit rather than being embedded in the doc metrics prototype page, since their relevance goes beyond just using and interpreting the doc metrics data -- these are core tech writing practices and tactics.
Once we determine where this content should live, the links and sections in https://www.mediawiki.org/wiki/Documentation/Tools/Metrics_generator can be updated to instead point there.