DEV Community

Cover image for Documentation is marketing
Benoît Moenne-Loccoz
Benoît Moenne-Loccoz

Posted on

Documentation is marketing

To continue with marketers reflexes, you must stop spending too much time into your website or your landing page. You wasting your time for nothing. Have you ever seen a shop with a beautiful store front with nothing inside? No, so stop it now.

It’s not the call to action wording or the tagline of the hero that will drive your growth. Just be clear and conscis, few lines of text would do the job correctly. In most of cases, a Notion is enough to present your product or better your Readme Github repository!

No need to think about If you have to choose between Framer, Webflow or Strapi because everyone doesn’t care about that. Instead of that, the only place that you should spend time to writing content is for your technical documentation.

Bad documentation isn’t just a missed opportunity. It’s an insult. If your docs are a mess, developers will assume your tool is too. Comprehensive, well-organized, and developer-friendly documentation isn’t a bonus: it’s the bare minimum. Stripe and Twilio didn’t dominate their markets because of slick branding. They crushed it because their documentation makes developers look like geniuses.

Few weeks ago, I took the time to explore the Stripe API documentation. And what a claque! I’m not developer and my tech skills are near to the level of the sea but it was so easy to understand. A 7 years old child could easily follow the step-by-step guide to get started with the Stripe CLI. The documentation was so strategic for the Stripe team that they decided to create their own tool for creating custom documentation aka https://markdoc.dev/.

Anyway, please respect developers and provide them a clear and complete documentation.

Retry later

Top comments (0)

Retry later
Retry later