Category: documentation

Mermaid – another text to diagram tool

9th April 2024

The post discusses various text-to-diagram tools like WebSequence Diagram, PlantUML, and WaveDrom, and introduces a newcomer, Mermaid. The author embraces Mermaid due to its automation capability, integration with GitHub, and support for block diagrams, expressing intent to use it for future architecture diagrams. The constant evaluation of tools to fill specific needs is emphasized. … More Mermaid – another text to diagram tool

How’s my sabbatical treating me?

30th December 2023

Ever since 2006, I have wanted to take a sabbatical. I wanted to take some time away from working on schedule-driven projects for my employer and do something for me instead. Why have I only wanted one since 2006? That’s a tale steeped in office politics and tech start-up financial drama. What I wanted to do during my sabbatical has varied, but it has always been more about writing (fact or fiction) or travelling than coding. The travel would have been a tour of India, to catch up with friends I met in Silicon Valley who have returned home. Fictional writing would have been purely for me, a complete shift away from work. Now I finally have the opportunity to take a sabbatical I have decided to try to write a book. … More How’s my sabbatical treating me?

Should I rush a post?

18th December 2023

The blogger began posting years ago, finding a balance between work and writing. When a full-time job took over, blogging ceased. Resuming during a 3-month sabbatical, the blogger found pressure in meeting a weekly schedule and questioned whether quick posts on the writing process truly add value. Unexpected issues often hinder writing, but also provide future content. … More Should I rush a post?