Hoppa till innehåll
Diagrambibliotek

Diagram

Ett växande bibliotek med arkitektur- och flödesdiagram som referens - tänkt att publiceras med Mermaid- eller Excalidraw-källa du kan kopiera och anpassa till din egen stack. Biblioteket är i ett tidigt skede. Tills de fristående diagrammen ligger uppe hittar du dem inbäddade i guider och jämförelser.

02

Varför ett separat diagrambibliotek?

Arkitektur- och flödesdiagram är ofta det första någon ritar när ett nytt system ska förklaras – och det första som blir inaktuellt. Genom att samla dem här, med källan (Mermaid eller Excalidraw) tillgänglig, går de att återanvända, anpassa och hålla levande. Ett diagram som bara finns som PNG i en presentation är en ögonblicksbild; ett diagram med öppen källa går att vidareutveckla.

Biblioteket är tänkt som referens snarare än konst: varje diagram har en tydlig avsändare och publiceras med en kort förklaring av vad det visar, vilka antaganden som gjorts och när det senast uppdaterades. Det gör det användbart både som underlag i en arkitekturdiskussion och som en utgångspunkt för er egen dokumentation.

03

Så kan du använda diagrammen

Alla diagram publiceras under en tillåtande licens och med källan exponerad. Du kan kopiera Mermaid-koden direkt och bädda in den i er egen dokumentation, eller ladda ner Excalidraw-filen och anpassa den till er stack. Det enda jag ber om är en kort attribution om diagrammet används i ett externt sammanhang.

De första diagrammen kommer ur guider och tjänstesidor där de redan finns inbäddade – här blir de fristående och sökbara. Nya diagram läggs till i takt med att de ritas i uppdrag eller för nya guider. Saknar du ett specifikt arkitekturmönster? Säg till, så hamnar det i kön.

Vill du veta när diagrambiblioteket fylls på?

Jag aviserar nya referensdiagram med kopierbar Mermaid-källa via nyhetsbrevet. Lågfrekvent, inga reklamutskick.

Prenumerera