elharo opened a new pull request, #2022:
URL: https://github.com/apache/maven-resolver/pull/2022
## Summary
Rewrites `src/site/markdown/what-is-resolver.md` so that it follows the
ASD-STE100 Simplified Technical English rules.
## Changes
- Classify the page as descriptive text. Use simple tenses only.
- Remove all banned modals (would, may, might, could, should).
- Remove contractions and present-perfect forms.
- Remove gerund and participle verb forms, including in the heading
("Embedding Resolver" became "How To Embed Resolver").
- Keep every sentence at or below 25 words and every paragraph at or below
six sentences.
- Remove non-factual filler words such as "well", "probably", and "your best
bet".
- Keep code identifiers, product names, and the license header unchanged.
## Verification
Grepped the page for contractions, "has been", banned modals, ", making",
and semicolons. All checks pass. The only remaining \"-ing\" word is the
adjective "interesting".
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
