Skip to content

Design memo for the format-metadata framework - #306

Open
balbasty wants to merge 1 commit into
mainfrom
claude/docs/233-metadata-design
Open

balbasty wants to merge 1 commit into
mainfrom
claude/docs/233-metadata-design

Conversation

@balbasty

@balbasty balbasty commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Part of #233, split out of #287.

Adds docs/design/format-metadata.md, the design memo for the format-metadata framework. It records:

  • the decisions M1–M13;
  • the addenda from each review round, the latest being the two hooks, FileBasedMetadata in io, and _import dropped;
  • the questions still open.

Docs only, no code.

Stack

  1. this PR: design memo, based on main
  2. Vocabulary enums, based on main
  3. Core helpers, stacked on 2
  4. FormatDispatcher mixin and small fixes, based on main
  5. The metadata system, stacked on 1–4
  6. Wire format metadata into images and transformations (#233) #287: wiring into images and transformations, stacked on 5

🤖 Generated with Claude Code

https://claude.ai/code/session_01VmK1jLTwd2hMkvYnMWEyYw


Generated by Claude Code

The design of format metadata and of the conversion of metadata
between formats: the Metadata -> FileBasedMetadata -> <Fmt>Metadata
hierarchy, the vocabulary groups, the raw record and its snapshot, the
metadata field of images and transformations, loss reports, and the
per-format mappings. Decisions M1..M13 and the open questions close it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VmK1jLTwd2hMkvYnMWEyYw

This branch has not been deployed

No deployments
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