Architecture Decision Records
Short records of decisions that are expensive to reverse or easy to re-litigate without a written
rationale. One file per decision, numbered sequentially (0001-*.md, 0002-*.md, ...), never
renumbered or deleted once merged — a superseded decision gets a new ADR that says so and links
back.
Use the lightweight format: Status, Context, Decision, Consequences. Keep it to what a future
contributor needs to not redo the argument; put implementation detail in specs/ or code comments
instead.
Index
- 0001: Repository layout
- 0002: Designer-authored comments become a P3b feature, not a P1 addition
- 0003: Analyzer promotion and string literal discipline
- 0004: Canvas overlays go through a pointer-anchored host,
CanvasPopup - 0005: Release, packaging and docs stack
- 0006: Parallel desktop E2E via a worker pool, one class per scenario
- 0007: XAML practices for the Avalonia editor
- 0008: CI code coverage uses static instrumentation only
- 0009: Split
NetPrints.Generationout ofNetPrints.Generator - 0010: Extension testing, coexistence rules and API compatibility gates
- 0011: The sourcemeta
jsonschemaCLI validatesschemas/netpc.v1.schema.json - 0012: One catalog engine over Roslyn symbols, shared as source with the generator
- 0013: Catalog profiles are declarative data
- 0014:
NetPrints.Annotationsis a generator-only package with embedded catalogs - 0015: The
netprintsCLI: command surface and exit-code contract - 0016: Git integration for graph files: text conversion, merge driver and SchemaStore
- 0017: Experimental API opt-in is per project and per id
- 0018: The editor shell docks with Dock.Avalonia, behind a shell seam (accepted, implemented in P3a, spike passed)
- 0019: CI runs one job per test project, and a Windows job checks the CLI (accepted, implemented in P3a)
- 0020: One contribution registry drives the editor's commands, panels and menus (accepted, implemented in P3a)
- 0021: Editor icons come from one vector family, Material Design Icons, named by icon id
- 0022: A pre-release editor build writes the latest released SDK version
- 0023: The editor's base theme and controls are Semi.Avalonia and Ursa.Avalonia
- 0024: Analyzer and generator infrastructure: four Roslyn projects, four rule families
- 0025: Node pins are declared as typed partial properties, and their keys are tracked
- 0027: Localization keys and display text
- 0028: Node search providers, node creation and ranking
- 0029: Node capabilities are role interfaces, and pins carry roles that decide purity
- 0030: The Extensibility package is split into Abstractions and host, with the editor as a facet
- 0031: The editor composes with MS.DI and our own registration generator
- 0033: Logging goes through NLog 6 behind
ILogger, and per-user files live in per-OS folders - 0034: Smart enums keep behaviour in each member; generic math builds the primitive table
- 0035: Editor themes are data
- 0036: Member defaults and editor metadata
- 0037: Run profile kinds
- 0038: The C# target and feature requirements
- 0039: User attributes and their editor extension model
- 0040: Editor settings: one store, typed sections, generated pages and user key bindings
- 0041: Extension packages,
netprints extension verifyand the author workflow
Numbers 0026 and 0032 are reserved by the roadmap for ADRs not yet written (node kinds, graph rules); 0031 and later were written first. Declarative pins (0025), localization (0027), node search (0028), node capabilities (0029) and the Extensibility split (0030) are written.