Should you ever lie or bend the truth in user documentation?

An interesting thread on Twitter from Scott Berkun:

There are Technical Authors who write “start here”, where there could be more than one place to do it. This is for good reasons – to avoid overchoice, and to give users the fastest path to the solution.

Topics chosen for tutorials can be focused on something that provides a reward quickly. For example: getting a “Hello World” response from an application or API. That approach can encourage users to spend more time with the product.

And the signs on the tube sometimes lie for good reasons:

Although, the newer tube maps actually address the “walking is faster” issue:

Apart from that – no, it’s best to be honest and tell the truth.

 

Leave a Reply

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

This site uses Akismet to reduce spam. Learn how your comment data is processed.