3 ms·
> "Working software over comprehensive documentation" > Tends to make very frustrating-to-use software, because it's never fully working and has minimal docume
by Sohcahtoa82 4y ago
> "Working software over comprehensive documentation"
> Tends to make very frustrating-to-use software, because it's never fully working and has minimal documentation.
Another problem:
It makes onboarding new engineers difficult. Without any documentation on what each API endpoint does, or the purpose of every repo, getting an understanding of how the system works ends up requiring scanning through code manually or taking a lot of time from other engineers asking questions.
It's especially bad when microservices are given non-descriptive names like Galactus or Omega Star.
- brazzy 4y ago"over" does not mean "to the complete exclusion of". The point is that documentation by itself doesn't deliver any value, and there are diminishing returns with amount and detail level of documentation. Agile doesn't say you shouldn't document, it says you shouldn't spend more time documenting your API endpoints than Implementing them.
- t43562 4y agoRather have a big document for a program that doesn't work?
- Dudeman112 4y agoYes You can get there with a big document for a program that doesn't work You can't get anywhere with a program that works and no document. You might get sales, but that's someone else's job I certainly would have preferred just a big document instead of the code I was given on my current role
- t43562 4y agoI meant: you'd be happy to hand your stakeholder a document about the code you would have written if you'd had time to?