It’s true when they say people don’t read.
People are busy, they don’t have time to read through hundreds of pages of how-to’s in your knowledge base, no matter how many you’ve written for them.
I don’t even read IKEA user manuals (and as my father would say, read the f*cking manual!)
Over the years I have created various product help resources, so I thought I’d write a little something about how to optimize your own documentation so that it’s actually helpful (and hopefully, people will actually start reading!)
If you want your docs to get read, here’s how to get started 👇
TLDR, in case you choose to not read 😂
- Rule 1: Stop calling it a “User Manual”
- Rule 2: Focus on the problem
- Rule 3: Support documents are not there to replace your UX
- Rule 4: Offer learning alternatives
- Rule 5: Set up a document structure
- Rule 6: Avoid image debt
- Rule 7: Make help accessible
- Rule 8: Documentation is not static
