4 ms·
Over the decades I have come to dislike templates and various architecture formats, I seem to always waste time catering to the tool and format and not enough t
by Scubabear68 4y ago
Over the decades I have come to dislike templates and various architecture formats, I seem to always waste time catering to the tool and format and not enough time communicating what’s important.
I mostly do free-form diagramming, mostly of process level architecture and integrations.
I haven’t looked at class level diagrams in years, which maybe says something about the limits of OOP and composition over inheritance.
On the data side I do like to have a stripped down ER diagram. By stripped down I mean a focus on the key tables and relationships, not every little table and key out there.
The purpose is always to show how data flows, where bottlenecks may be, how scaling happens, and how other non functional requirements are satisfied. Try to keep them simple and to the point, and do try to maintain them (at a minimum, date them!).
Outside of something specialized like a sequence diagram I actually usually just use Keynote.
- ChrisMarshallNY 4y agoI have used a sort of "UML Lite,"[0] from time to time, but that's about as formal as I get. Normally, I have some kind of "block diagram," on what I call a "napkin sketch."[1] A lot of documentation is in my head. But I also tend to work on my own, or on standalone modules. When we have a team (and I used to work for a Japanese engineering company, so this goes double), the standardized methodology becomes quite important. [0] https://littlegreenviper.com/miscellany/swiftwater/the-curious-case-of-the-protocol-default/ https://littlegreenviper.com/miscellany/swiftwater/the-curio... [1] https://littlegreenviper.com/miscellany/forensic-design-documentation/ https://littlegreenviper.com/miscellany/forensic-design-docu...
- cortesoft 4y ago> Over the decades I have come to dislike templates and various architecture formats, I seem to always waste time catering to the tool and format and not enough time communicating what’s important. This is interesting, because I often find the opposite; that without a template or format, I spend too much time worrying about how to structure what I am creating instead of getting out the content.
- deleted 4y ago[deleted]