Alessandro 'kLeZ' Accardo personal website

The personal website of an Italian developer. /nick kLeZ, since forever.

Tag: software architecture

blueprint.el: documenting architecture, before and after the code

Today I’m introducing blueprint.el, an Emacs package I wrote for a job I do often and that, let’s say, nobody is exactly wild about: rebuilding the architectural documentation of software systems that don’t have any, starting from the code. That’s where it was born, but the method it carries with it works just as well from the other side, when the code doesn’t exist yet and you’re the one designing the architecture. It’s all text, all Org, and it works perfectly well by hand. But it’s designed for a team: several people, or several agents, working on it together, each on their own piece, leaving only the decisions to whoever is coordinating.

And I’m proud of it, I’ll say that up front. A job like this, in Word, is simply unthinkable, and blueprint gave me an effective, goal-focused way of organising it, and one way or another it has to be organised anyway.