Come documentate le vostre architetture HW?

[Leonardo]

Salve a tutti,

In progetti non banali come documentate ai vari livelli di astrazione l'architettura del sistema?

Mi riferisco in particolare alla documentazione di alto livello in un contesto collaborativo dove l'esigenza è spiegare e lavorare assieme per rifinire al meglio l'architettura con astrazioni a blocchi di sistema e loro connessioni.

Oltre alla lavagna e a carta e penna avete qualche suggerimento come ad esempio software particolari per creare poi presentazioni di alta qualità?

Grazie anticipatamente a tutti

[legacy]

a me, nel piccolo team (3..6 persone), non e' mai servito andare oltre Dia, integrato con email, telefonate, e riunioni

[Leonardo]

Grazie legacy,

Dia (Dia Diagram Editor) sembra interessante come software, gli darò una sbirciatina

Rispetto a carta e penna ha l'overhead di doverlo insegnare agli altri partecipanti ma se è abbastanza intuitivo è un problema superabile.

L'hai usato con un set di simboli personalizzato o ti è bastato il set standard?

[legacy]

di che progetto parliamo ? roba universitaria ? se si, e' sempre stato ampiamente sufficiente

Code: Select all

app-office/dia
      Homepage:      https://wiki.gnome.org/Apps/Dia
      Description:   Diagram/flowchart creation program


Dia e' nato come flowchart (tipico dell'algoritmica), ma col tempo ha accumulato abbastanza simboli per essere usabile anche in impiantistica, in telematica per rappresentare sottoreti con router, switch, host, etc, se la cava bene anche nei sinottici piu' semplici. tipici della sicurezza perimetrale, per rappresentare i concertatori di archi, barriere, telecamere, anti incendio, etc, ma a parte tutto offre il grosso vantaggio di offrire delle primitive che si possono "raggruppare" e "congelare" in un solo oggetto mantenendo tutti i vincoli

i vincoli sono utili per collegare tra loro blocchi nel punto giusto e con l'etichetta giusta, il tutto con un due click

e' abbastanza rapido da imparare, richiede un po' di malizia