2 ms·
This is perhaps a tangent, but I've used https://asciiflow.com/#/ https://asciiflow.com/#/ a few times now to insert diagrams into my source code as comments. I
by moskie 4y ago
This is perhaps a tangent, but I've used https://asciiflow.com/#/ https://asciiflow.com/#/ a few times now to insert diagrams into my source code as comments. I understand people might have negative opinions on the efficacy of comments that this would only exacerbate, but nevertheless I've appreciated what AsciiFlow gave me.
- techdragon 4y agoI’ve been using MonoDraw https://monodraw.helftone.com/ https://monodraw.helftone.com/ for this exact sort of stuff for years, was one of the main reasons I bought the program actually. A good diagram in a block comment right above or below done complicated code is a ready powerful way to make sure you’re going to be able to maintain that code in the future. I find flowchart style diagrams for finite state machines and UML(ish) sequence diagrams for RPC code are both extremely handy places to add a diagram.
- grepfru_it 4y agoWhat is great is that this becomes code. The next person modifying this workflow will be blamed for not updating the diagram. Now you always have up to date architecture (until someone removes the comments lol)