Alessandro 'kLeZ' Accardo personal website

Il sito personale di uno sviluppatore. /nick kLeZ, da sempre.

Tag: architettura software

blueprint.el: documentare l'architettura, prima e dopo il codice

Oggi vi presento blueprint.el, un pacchetto Emacs che ho scritto per un lavoro che faccio spesso e che, diciamo, non fa impazzire nessuno: ricostruire la documentazione architetturale di sistemi software che non ce l’hanno, partendo dal codice. È nato lì, ma il metodo che si porta dietro vale anche dall’altra parte, quando il codice non c’è ancora e l’architettura la stai progettando. È tutto testo, tutto Org, e si usa benissimo anche a mano. Però è pensato per una squadra: più persone, o più agenti, che ci lavorano sopra insieme, ognuno sul suo pezzo, lasciando a chi coordina solo le decisioni.

E ne vado fiero, lo dico subito. Un lavoro del genere, in Word, è semplicemente impensabile, e blueprint mi ha dato un modo efficace e centrato sull’obiettivo di organizzarlo, che tanto, in un modo o nell’altro, va organizzato comunque.