You dont get a compile error if the documentation is wrong. Chances are you wont... | Hacker News

Hacker News new | past | comments | ask | show | jobs | submit

login

tjoff 6 months ago | parent | context | favorite | on: Diátaxis – A systematic approach to technical docu...

You dont get a compile error if the documentation is wrong. Chances are you wont notice.

And even if it eventually is fixed it is not obvious that the reason for the bug was that the documentation was wrong in one particular place.

smeej 6 months ago [–]

And by then you have several people on the team who have thought the wrong way is the right way for months, never mind your support team probably giving end users bad information.

It's messy.

Consider applying for YC's Fall 2025 batch! Applications are open till Aug 4
Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact