How to Lose Developers and Alienate Users: 5 Ways Not to Write Docs

Written by alexcg | Published 2020/08/26
Tech Story Tags: documentation | user-experience | how-to-write-documentation | dev-comics | second-human-rule | ux | coding | software-development

TLDR Developer Relations Lead at Jina AI, a startup focusing on neural search, explains how to write your docs. The tales of woe below are all true, and I’ve personally experienced them…and worse. To make your docs stand out, why not make them crappy instead? And who needs GitHub Stars when you have an issue queue overflowing with basic questions? The perfect enemy of the good is the good of users, and pushing users to master master users is the enemy of good blood.via the TL;DR App

no story

Written by alexcg | Developer Relations Lead at Jina AI. Maker of animatronic butterflies and AIs that write bad Star Trek
Published by HackerNoon on 2020/08/26