Architecture decision records
The non-obvious calls, written up as they were made — in chronological order. Each records the context, the decision, the alternatives weighed, and the consequences.
- ADR 0001 — Rust workspace & W3C Web Annotation wire format
- ADR 0002 — Content-addressed dedup id via RFC 8785 JCS
- ADR 0003 — Self-signed P-256 identity (federating) + OAuth silos
- ADR 0004 — All validation in SHACL, never OWL/RDFS
- ADR 0007 — JSON-LD is primary on ingest, not interop
- ADR 0008 — Durable demo storage via JSON-Lines snapshots
- ADR 0009 — Custom rating scales via sh:lessThanOrEquals
- ADR 0010 — JWT export profile (PUT /submit/{jwt})
- ADR 0011 — Full JSON-LD via compaction against the pinned context
- ADR 0012 — HTTP cache freshness + validators between collection and feedback servers
- ADR 0013 — WebCrypto P-256 signing in the widgets (browser-native federating identity)
- ADR 0014 — NIP-65-style relay list: the outbox discovery model
- ADR 0015 — Discovery hardening: liveness, signed announces, relay-list gossip
- ADR 0016 — Storage durability: SQLite mock + persistent collection state
- ADR 0017 — Negentropy (NIP-77) range-based sync for backdated reconciliation
- ADR 0018 — feedback-server conformance hardening
- ADR 0019 — Deployment: musl static binaries, RocksDB durable backend, release pipeline
- ADR 0020 — Canonical domain: freedback.net
- ADR 0021 — Right to erasure: author-signed deletion replaces "append-only"
- ADR 0022 — Data licensing: a rights IRI on the annotation, a default license in the well-known
- ADR 0023 — The issue / problem-report feedback type
- ADR 0024 — Replies & threaded discussion via oa:replying