debian-mirror-gitlab/doc/.vale/gitlab/ReadingLevel.yml

14 lines
504 B
YAML
Raw Normal View History

2021-10-27 15:23:28 +05:30
---
# Suggestion: gitlab.ReadingLevel
#
# Checks the Flesch-Kincaid reading level.
#
2022-03-02 08:16:31 +05:30
# https://docs.errata.ai/vale/styles#metric
extends: metric
message: "The grade level - %s - refers to how hard the content is to understand. Aim for 8th grade or lower by using shorter sentences and words."
2021-11-11 11:23:49 +05:30
link: https://docs.gitlab.com/ee/development/documentation/testing.html#vale-readability-score
2021-10-27 15:23:28 +05:30
level: suggestion
2022-03-02 08:16:31 +05:30
formula: |
(0.39 * (words / sentences)) + (11.8 * (syllables / words)) - 15.59
condition: "> 1"