That fits perfectly with the idea that everything should actually be in the repository. At last, I no longer have to update the images myself. Thanks!
I use Excalidraw to manage my diagrams for my blog
41–50 of 120 posts
Re: I use Excalidraw to manage my diagrams for my blog
#42Documentation often rots away because it's often decoupled from the code it describes.
I'm a huge fan of anything related to code that can I check into git, track its evolution and the thinking that went behind it. Why was Kubernetes chosen? Why was NATs chosen? Why are the topics named the way they are?
I am a huge fan of mermaid diagrams because it lets me check in my diagrams into git. I am a huge fan of mermaid diagrams because my code can generate diagrams that I (or they) can check into git - and this was before AI.
Now that AI can generate mermaid diagrams, people look at my Git repos and go "oh, you use AI a lot!" - then I point to my git history and they see it's from 2018.
I'm really happy that mermaid and related tools like Excalidraw are taking off - we have another chance at documentation being automated, uptodate and "fresh".
Re: I use Excalidraw to manage my diagrams for my blog
#43Uh, that’s a nice approach.
Re: I use Excalidraw to manage my diagrams for my blog
#44I want to write a blog whose posts will be all about the technical details of how the blog works.
Re: I use Excalidraw to manage my diagrams for my blog
#45I love diagramming, but I genuinely don't understand how people can use these wonky looking tools. It looks off, I had to make my own[1] to create something that's easy to use and looks good/normal. [1] https://grafly.io
This looks really clean, nice work. I’ve had the same issues with most diagramming tools, it's either not so good looking or the insane pricing .
I went a different route using diagram-as-code with Mermaid instead of manual drawing.
Re: I use Excalidraw to manage my diagrams for my blog
#46I love diagramming, but I genuinely don't understand how people can use these wonky looking tools. It looks off, I had to make my own[1] to create something that's easy to use and looks good/normal. [1] https://grafly.io
I like the wonky, hand-drawn looking style. I think it fits well beause usually if I use a diagram it's not 100% precise and accurate, but more a high-level illustration. The wonky style conveys the approximate precision of the presented concept. Also, and that's personal, I think it's cute.
I agree with you. I think the 'wonky' comment was more to serve as justification for the plug than an actual criticism of Excalidraw.
Excalidraw is my favourite thinking tool, and the style it produces is just the right level of limiting, disarming, and professional at the same time.
Re: I use Excalidraw to manage my diagrams for my blog
#47I love diagramming, but I genuinely don't understand how people can use these wonky looking tools. It looks off, I had to make my own[1] to create something that's easy to use and looks good/normal. [1] https://grafly.io
When a background shape is in focus it comes to the foreground covering the shapes that are on top of it.
Re: I use Excalidraw to manage my diagrams for my blog
#48Great article, should make sure to attribute xkcd comics though. https://xkcd.com/about/
Thanks for the hint - just updated the post and adde the attribution
Re: I use Excalidraw to manage my diagrams for my blog
#49Huge fan of https://github.com/mermaid-js/mermaid, not the prettiest things but enough to scratch the itch.
Re: I use Excalidraw to manage my diagrams for my blog
#50Huge fan of https://github.com/mermaid-js/mermaid , not the prettiest things but enough to scratch the itch.
Author here: I use mermaid lot as well and for some things like process flows, and to model interactions it it outrules excalidraw and posts will follow where i need exactly that. but to visualize things high level i find excalidraw way nicer.