Review 'Lint prose' page

[jdbaldry]

• Avoid needing to explain the Grafana/AllowsTo rule in the documentation.
• Add context in page description
• Present human readable output when users run make vale

Closes https://github.com/grafana/writers-toolkit/issues/679

Signed-off-by: Jack Baldry jack.baldry@grafana.com

[github-actions[bot]]

Readability report

File	AutomatedReadability	ColemanLiau	FleschKincaid	FleschReadingEase	GunningFog	LIX	SMOG
docs/sources/review/lint-prose/index.md	$${5.54\space\color{green}(Δ-0.27)}$$	$${8.75\space\color{green}(Δ-0.31)}$$	$${6.99\space\color{green}(Δ-0.12)}$$	$${62.31\space\color{green}(Δ+0.68)}$$	$${9.50\space\color{red}(Δ+0.19)}$$	$${30.83\space\color{green}(Δ-0.98)}$$	$${10.19\space\color{green}(Δ-0.01)}$$

View metric targets

| Metric | Range | Ideal score | | --- | --- | --- | | [AutomatedReadability](https://en.wikipedia.org/wiki/Automated_readability_index) | 6 (very easy read) to 14 (extremely difficult read) | 8 or less | | [ColemanLiau](https://en.wikipedia.org/wiki/Coleman%E2%80%93Liau_index) | 6 (very easy read) to 17 (extremely difficult read) | 9 or less | | [FleschKincaid](https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests) | 6 (very easy read) to 17 (extremely difficult read) | 8 or less | | [FleschReadingEase](https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests) | 100 (very easy read) to 0 (extremely difficult read) | 70 or more | | [GunningFog](https://en.wikipedia.org/wiki/Gunning_fog_index) | 6 (very easy read) to 17 (extremely difficult read) | 10 or less | | [LIX](https://en.wikipedia.org/wiki/Lix_(readability_test)) | 20 (very easy read) to 60+ (extremely difficult read) | 35 or less | | [SMOG](https://en.wikipedia.org/wiki/SMOG) | 6 (very easy read) to 17 (extremely difficult read) | 10 or less |