Writing

Using "recommend" in tech docs

In our Write the Docs Slack network, a member asked if we knew of any best practices on using the word “recommend” in technical documents. There are no official best practices, so we all had different suggestions, such as:

All these suggestions make sense, depending on the type of document, user, and product. The main agreement is that we shouldn’t use “recommend” too much, but when we do, provide context and make sure it’s noticeable and neat.