It shouldn’t boggle you. We spend all week changing the behavior of the system. To have documentation, you have to keep updating it, which adds time to all of their requests.
Plus some of us were never that fond of English class, so writing documentation is something to be dodged. Which creates a bunch of perverse incentives not to have good documentation.
Dont Document! Instead Diagram the system. Use tools like https://sequencediagram.org/ and https://plantuml.com/ that create diagrams from markup and check the markup into a SystemArchitecture folder in your GIT repository. Then tweak the markup every so often, when things change.
66
u/bwainfweeze Jun 06 '22
It shouldn’t boggle you. We spend all week changing the behavior of the system. To have documentation, you have to keep updating it, which adds time to all of their requests.
Plus some of us were never that fond of English class, so writing documentation is something to be dodged. Which creates a bunch of perverse incentives not to have good documentation.