This rule identifies instances where multiple hyphenated words are joined with "and" using a shortened form. This style can make text less readable and clear, even though it might save space. Microsoft's style guide recommends avoiding this construction unless space is extremely limited, as writing out the full terms makes the content more accessible and easier to understand.
This rule will flag constructions like:
The rule looks for patterns where a hyphenated word is shortened by using the hyphen before "and" followed by another hyphenated word. It will generate a warning when it finds these constructions, suggesting that the writer spell out both terms completely.
This rule comes from: https://github.com/mesosphere/dcos-docs-site
extends: existence
message: "Don't use '%s' unless space is limited."
link: https://docs.microsoft.com/en-us/style-guide/punctuation/dashes-hyphens/hyphens
ignorecase: true
level: warning
tokens:
- '\w+- and \w+-'