Hacker Newsnew | past | comments | ask | show | jobs | submitlogin
Is Agile Documentation an Oxymoron? (nuclino.com)
4 points by rohtul on May 20, 2019 | hide | past | favorite | 2 comments


Despite what some may say, some level of documentation is needed in Agile. Agile is not an excuse to be a cowboy.

Having said that, not being a cowboy does not mean being wasteful. You don't install documents in production. Be sane. Document only what's needed for regulatory, GAAP or other purposes. If you need to document in case someone leaves, you don't have collective code ownership and aren't pairing properly.


We treat both external documentation and internal documentation as a deliverable in a sprint. Working on documentation iteratively has the same benefits as working on code the same way.

What Agile is against is large up front specifications, not documentation per se.




Consider applying for YC's Winter 2026 batch! Applications are open till Nov 10

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: