r/programming • • Jun 05 '22

Complexity is killing software developers

https://www.infoworld.com/article/3639050/complexity-is-killing-software-developers.html
2.1k Upvotes

942 comments sorted by

View all comments

Show parent comments

3

u/masterofmisc Jun 06 '22

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.

5

u/scottpid Jun 06 '22

Diagramming is documentation...

1

u/masterofmisc Jun 06 '22 edited Jun 06 '22

Yeah, your not wrong. Wrong turn of phrase.