1 - Stay simple
We all want to add every single detail in our documentation. But sometimes, less is more. Get straight to the point.
2 - Avoid patronizing vocabulary
“It’s super easy”… Yet, if your users are struggling to follow the steps in your documentation, that can make them feel bad and give up. Avoid patronizing language in your documentation as much as you can.
3 - Make it searchable
If your documentation is a standalone site, make it searchable. Tools like Algolia allow you to implement a search engine on your site with a few steps.
4 - Be polyglot
If you can, display the code snippets in multiple languages, relevant to your users.
You can also find these pixels on my Instagram: https://instagram.com/valentinprgnd. I will publish Pixels every Monday, Wednesday, and Friday about career development in tech, code, mental health and health for developers. Follow me for more tips @valentinprngd and check out my podcast https://rebased.whatdafox.com.
Top comments (0)