technical-diagram
Technical Diagram
Produce the smallest accurate technical figure. D2 is the default authoring language, ELK owns layout, and SVG is the primary deliverable. Keep the source beside the render so the diagram remains reproducible without a GUI.
Quick path
-
Form the reader brief in the content contract below. Reduce the source to one question and one answer before choosing nodes.
-
Derive the required nodes, edges, groups, and annotations from that brief. Source facts that do not support the answer stay outside the figure.
-
Read
references/editorial-principles.mdandreferences/d2-authoring.md. -
Copy
assets/editorial-theme.d2beside the new source and import it. Author only the semantic structure in the main.d2file. -
Format the source with
d2 fmt <file>.d2, then render it with:bash scripts/render_d2.sh <file>.d2 <file>.svg -
Inspect the rendered SVG, using a temporary PNG proof when the available viewer cannot display SVG. Apply
references/review.md, remove any unrequired content, and render again after each fix.