Ask HN: How can we improve Public Developer Documentation?

1 points by bnchrch 5y ago ↗ HN

Some companies seem to get developer documentation and support right (Stripe, Plaid, Netlify).

While others seems to struggle either outputting content, keeping it up to date or maintaining clarity. (Auth0, Yodlee).

What does HN think the biggest barrier to maintaining healthy public facing docs is?

1 comment

[ 5.3 ms ] story [ 9.3 ms ] thread

bnchrch 5y ago ↗

One area I think is particularly challenging is wrangling third party tutorials. Either no one has written a stellar "get started tutorial" yet, or the existing one that ranks well on google is out of date.