The primary goal of technical writing is to provide useful and necessary information.
Write Simple
Write Simple

Write Simple

ORIGINAL:

The AWS container services team maintains a public roadmap on GitHub. It contains information about what the teams are working on and allows all AWS customers the ability to give direct feedback. For more information, see AWS Containers Roadmap.

BETTER:

The AWS container services team maintains a public roadmap on GitHub. It contains information about what the teams are working on and allows all AWS customers to give direct feedback. For more information, see AWS Containers Roadmap.

EXPLANATION:

The phrase “the ability” is unnecessary. It’s also awkward to use with the word “allows”. As a second option, if “the ability” is used, “gives” should be used instead of “allows” and the word “give” should be replaced with “provides”. For example, the passage could be – The AWS container services team maintains a public roadmap on GitHub. It contains information about what the teams are working on and gives all AWS customers the ability to provide direct feedback. For more information, see AWS Containers Roadmap.

Leave a Reply

Your email address will not be published. Required fields are marked *