Skip to content

RFC 085: Identifiers of and within IIIF resources after the migration - #143

Merged
kenoir merged 11 commits into
mainfrom
rfc-085-iiif-identities
Aug 12, 2026
Merged

kenoir merged 11 commits into
mainfrom
rfc-085-iiif-identities

Conversation

@tomcrane

@tomcrane tomcrane commented Mar 2, 2026 •

Copy link
Copy Markdown
Collaborator

This RFC has been rewritten to record the direction agreed in the RFC 091 discussion (#159); amending RFC 085 was a named deliverable of that RFC.

The earlier version of this RFC proposed making the catalogue Work ID the canonical URI for IIIF Manifests and Collections, with b-number and CALM forms redirecting to it. The RFC 091 review reversed that: the preservation identifier stays the canonical IIIF URI, for old and new content alike, and the Work ID only ever appears as a redirect source.

Much of the original analysis, in particular Canvas IDs and annotation targets, which IIIF clients string-match inside the JSON and which can therefore never be redirected, turned out to be the argument for the reversal, so it is retained as the rationale.

The rewritten RFC covers:

  • The consequences of the decision at the IIIF layer, with examples for five permutations (digitised and born-digital,
    cross-migration and post-migration, Folio- and Axiell-catalogued). For all existing content the migration is invisible: every
    published URI stays exactly as it is.
  • The redirect contract: presentation/{workId} → presentation/{preservationId}, extended from informal behaviour to a DDS responsibility.
  • Constraints on the form of the new preservation identifier (supporting RFC 091's Folio HRID recommendation), and why sub-package identity (volumes, suffix-splitting) belongs to the DDS rather than the Identifiers API (RFC 089).
  • Canvas ID persistence: the previously proposed digest-matching apparatus becomes an optional robustness improvement, decoupled from the migration.

RFC 091 open questions:

  • multi-volume suffix convention (needs agreement with digital production / Intranda)
  • Axiell Ref stability across the CALM migration
  • Final confirmation of the HRID choice.

@kenoir kenoir changed the title Rfc 085 iiif identities RFC 085: IIIF identities Jun 18, 2026
@kenoir kenoir mentioned this pull request Jun 18, 2026
tomcrane and others added 2 commits August 4, 2026 13:11
Review notes on the #159 comment thread: the
preservation-identifier-canonical outcome, constraints on the form of new
preservation ids, the workId redirect contract, and open questions for the
RFC 091 rewrite.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The id-form concern splits in two: the Identifiers API absorbs the
metadata half (source system, canonical id, deferral instead of shape
inference), but the structural half (sub-package suffix parsing, CALM
underscore ambiguity, path/case constraints) is inherently local to DDS
since RFC 089 stops at the work level. Also records that the registry
cannot hold merge-redirect results, and that the DDS CatalogueId refresh
has been addressed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@tomcrane
tomcrane marked this pull request as ready for review August 7, 2026 14:08
@tomcrane
tomcrane requested review from a team as code owners August 7, 2026 14:08
@tomcrane tomcrane changed the title RFC 085: IIIF identities RFC 085: Identifiers of and within IIIF resources after the migration Aug 7, 2026

@kenoir kenoir left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good to go, I think we're aligned now.

If you are happy I will merge?

@kenoir
kenoir merged commit 3a11790 into main Aug 12, 2026
7 checks passed
@kenoir
kenoir deleted the rfc-085-iiif-identities branch August 12, 2026 14:52
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.

2 participants