Member-only story
RTFM! Users Won’t Read Your Documentation, Here’s A Better Approach
3 min readJul 18, 2022
It’s easy to be optimistic when writing detailed documentation for your product. You want to make sure there’s a wealth of knowledge in your user manual anyone can search for and find.
The sad reality is that nobody reads the user guides.
Instead of putting all your effort into perfect user guides, you should reduce the need for a user to refer to the documentation in the first place.
Here’s the why and the how:
The Pros Of Documentation:
- Online documentation is easily searchable.
- When organized right, it’s easy to find what you’re looking for.
- Something like Apple’s HIG is a fascinating resource to learn from.
The Cons Of Documentation:
- It takes you away from using the product.
- The act of searching for a solution to your problem is too much friction for most users.
- If a user can’t solve their problem they’ll leave your product and find another one.