Ask HN: How can we improve Public Developer Documentation?

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?