We all want to add every single detail in our documentation. But sometimes, less is more. Get straight to the point.
“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.
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.
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.