I'm writing ASCII diagrams for docs. It's not terribly pretty, but it's so easy to contribute to.
I've seen so many beautiful architecture diagrams go stale because no-one wants to find the file and the GUI tool to keep it updated.
miniblog.
Related Posts
I had a third attempt at porting difftastic from Dijkstra to A*, and I've eventually concluded that A* just isn't worth it for the implementation complexity.
I had fun writing it up though, and I've even attempted ASCII art for building intuitions:
I like the idea of tools like Pinboard or Karakeep that let you save copies of websites you've bookmarked.
I'm considering just writing a script that saves web pages as a .md in a private git repository though.
It feels crude. I think I get essentially all the benefits though?
I'm writing a Path type in my programming language but not sure what methods belong on a Path.
Should I have some_path.read_string() or fs::read_string(some_path) instead?
I love .method() for IDE completion, but I don't want Path to be cluttered. I'm also trying to avoid UFCS.
