Skip to content

docs: add position paper on identifier durability and machine-readable canonical IRIs - #58

Open
damienriehl wants to merge 6 commits into
CatholicOS:mainfrom
damienriehl:docs/identifier-durability
Open

docs: add position paper on identifier durability and machine-readable canonical IRIs#58
damienriehl wants to merge 6 commits into
CatholicOS:mainfrom
damienriehl:docs/identifier-durability

Conversation

@damienriehl

Copy link
Copy Markdown

Adds the position paper Identifier Durability: Machine-Readable Canonical IRIs to research/, filed as a public comment during draft-cdcf-catholic-uri-scheme-03 (v0.4.0)'s 60-day window. Announced in #56; discussion at #57.

Thesis: "and," not "or" — machine-readable canonical IDs that never drift, and a guaranteed human-readable layer (every existing slug preserved forever as a resolvable alias, multilingual labels, a mandatory label-rendering rule). Written as a small delta to draft 0.4.0: its two-artifact model, notations, and stability guarantee are kept; only which artifact is primary is inverted. A section-by-section amendments table closes the paper.

Contents of this PR:

  • research/identifier-durability-opaque-canonical-iris.md — the paper (registered in deploy-docs.yml, both build scripts, RELEASING.md, and the README per RELEASING.md's doc-adding rule; lint:md, build:html, and build:pdf all green locally).
  • standards/drafts/ — the two committee drafts the paper responds to, included verbatim as citable companions so every section reference resolves (both carry CC-BY 4.0 license rows). The committee is invited to relocate these to a canonical home; they are excluded from repo lint/format so their bytes stay untouched.

Two questions for maintainers:

  1. Licensing — the paper's metadata table carries CC BY 4.0 (matching the drafts it responds to and its nature as narrative prose), while the repo LICENSE is Apache-2.0. Guidance welcome on the preferred treatment.
  2. Drafts placement — is standards/drafts/ acceptable as the companions' home, or should they live elsewhere?

Companion suggested-change PRs are landing in crmedr, cledr, cecdr, ciclsaldr, clbdr, and cmddr, each demonstrating recorded identifier-churn cases from that repository's own history.

🤖 Generated with Claude Code

https://claude.ai/code/session_01MoZuH8vKiwL2rsX3a1zSqc

damienriehl and others added 6 commits July 26, 2026 13:10
…l IRIs

Draft 1 for committee discussion, with the two CDCF drafts it responds to
included verbatim under standards/drafts/ as citable companions (both CC-BY).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MoZuH8vKiwL2rsX3a1zSqc
… verbatim drafts from lint

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MoZuH8vKiwL2rsX3a1zSqc
…s voice, exemplar-rich executive summary, et-et framing, objections moved to disputatio position

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MoZuH8vKiwL2rsX3a1zSqc
…te-powder argument, Prevost timeline, authorship trendline, Agile framing, all-parties scaling, costs-to-zero

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MoZuH8vKiwL2rsX3a1zSqc
…ft consequence in executive summary

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MoZuH8vKiwL2rsX3a1zSqc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant