From 2b0bd8a7371e099b210413f3f638eb1adb92bffd Mon Sep 17 00:00:00 2001 From: Lukas Wuttke Date: Sat, 25 Jul 2026 12:26:47 +0200 Subject: [PATCH] docs(rfc): state qualified identifiers in the RFC headers MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit RFC numbers are assigned per repo, so a bare "RFC 0001" names four different documents across the org and "RFC 0002"/"RFC 0003" name two each. Add the qualified ID (`RFC-CLI-0001` … `RFC-CLI-0003`) to each header, in the blockquote style these documents already use. Two of the three also record which document the existing bare in-code references actually mean: nearly all `RFC-0001` comments across backend/cli/client point at RFC-CLI-0001, and the `RFC-0003` references in client's chart templates and docs/SEAL-CHECK.md point at RFC-CLI-0003 — not at backend's own 0001/0003. Nothing is renumbered and no file is moved, so existing links still resolve. The org-wide index lives in tracebloc/backend (private) at docs/rfcs/README.md. Co-Authored-By: Claude Fable 5 --- docs/rfcs/0001-cli-auth-and-client-provisioning.md | 6 ++++++ docs/rfcs/0002-data-ingest-flow.md | 4 ++++ docs/rfcs/0003-storage-and-offboard-hygiene.md | 6 ++++++ 3 files changed, 16 insertions(+) diff --git a/docs/rfcs/0001-cli-auth-and-client-provisioning.md b/docs/rfcs/0001-cli-auth-and-client-provisioning.md index ff49b697..7f1ccab7 100644 --- a/docs/rfcs/0001-cli-auth-and-client-provisioning.md +++ b/docs/rfcs/0001-cli-auth-and-client-provisioning.md @@ -1,5 +1,11 @@ # RFC 0001 — Browser-based auth & one-command client provisioning +> **Qualified ID: `RFC-CLI-0001`.** Cite this document by its qualified ID, never as +> a bare "RFC 0001" — `backend` and `client` each have their own 0001. Note that +> most existing bare `RFC-0001` references in the `backend`, `cli` and `client` +> codebases mean **this** document. Org-wide index: `docs/rfcs/README.md` in +> `tracebloc/backend` (private). +> > **Status: ACCEPTED — implemented.** The design in this RFC shipped in > **CLI v0.4.0** ([cli#107](https://github.com/tracebloc/cli/pull/107)); the > tracking epic ([cli#54](https://github.com/tracebloc/cli/issues/54)) is closed. diff --git a/docs/rfcs/0002-data-ingest-flow.md b/docs/rfcs/0002-data-ingest-flow.md index 1a3f6814..df4207bd 100644 --- a/docs/rfcs/0002-data-ingest-flow.md +++ b/docs/rfcs/0002-data-ingest-flow.md @@ -1,5 +1,9 @@ # RFC 0002 — `tracebloc data ingest`: flow, terminology & task taxonomy +> **Qualified ID: `RFC-CLI-0002`.** Cite this document by its qualified ID, never as +> a bare "RFC 0002" — `backend` also has a 0002 (platform cost & autoscaling). +> Org-wide index: `docs/rfcs/README.md` in `tracebloc/backend` (private). +> > **Status: DRAFT — for discussion.** Owner: @LukasWodka. Last updated: 2026-07-07. > > This RFC captures the redesign of the `tracebloc data ingest` user diff --git a/docs/rfcs/0003-storage-and-offboard-hygiene.md b/docs/rfcs/0003-storage-and-offboard-hygiene.md index eeb381dd..2f21dfc4 100644 --- a/docs/rfcs/0003-storage-and-offboard-hygiene.md +++ b/docs/rfcs/0003-storage-and-offboard-hygiene.md @@ -1,5 +1,11 @@ # RFC 0003 — The secure environment: dataset storage, offboard hygiene & the boundary +> **Qualified ID: `RFC-CLI-0003`.** Cite this document by its qualified ID, never as +> a bare "RFC 0003" — `backend` also has a 0003 (configurable preprocessing & +> imputation). Note that the existing bare `RFC-0003` references in the `client` +> chart templates and `docs/SEAL-CHECK.md` mean **this** document. Org-wide index: +> `docs/rfcs/README.md` in `tracebloc/backend` (private). +> > **Status: DECIDED — v2.3; decisions D1–D20 locked (D1–D15 2026-07-22; > D16–D20 2026-07-23). Execution tickets filed and cross-linked in §10/§12; > D16–D20 (per-dataset isolation) are decided but not yet ticketed, with