2 ms·
I use what I call "UML Lite" (UML, without all the frou-frou). It's handy for illustrating points[0]. What I generally do, is start with what I call a "napkin
by ChrisMarshallNY 4y ago
I use what I call "UML Lite" (UML, without all the frou-frou). It's handy for illustrating points[0].
What I generally do, is start with what I call a "napkin sketch" (which can be UML-ish)[1], and try to avoid writing down too much stuff, in order to reduce "concrete galoshes"[2].
I try to use tools like Doxygen and Jazzy, to document the code, in an inline fashion[3]. Doxygen will generate a UML "Lite" diagram[4].
[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...
[2] https://littlegreenviper.com/miscellany/concrete-galoshes/ https://littlegreenviper.com/miscellany/concrete-galoshes/
[3] https://littlegreenviper.com/miscellany/leaving-a-legacy/ https://littlegreenviper.com/miscellany/leaving-a-legacy/
[4] https://doxygen.nl/manual/diagrams.html https://doxygen.nl/manual/diagrams.html