docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name - #4
Conversation
…the name Owner rulings 2026-09-14. 1. application/vnd.a2ml was NEVER filed with IANA. The header previously read "Submission Date: 2026-04-03 (Revision 2)", which reads as though the type is registered. It is not. Any reader — human or agent — arriving at this file would have concluded that vnd.a2ml is an allocated media type and that vnd.deed needed a change request against it. Both conclusions are false. The header now states plainly that the document was never submitted, that the string is unregistered, and that application/vnd.deed supersedes it, with a link to the registration actually being filed. 2. "A2ML" expands to "Attestation Markup Language". Three repositories each carried a different expansion (Attested Agent Markup Language here, Attestation Markup Language in deed-ecosystem, Annotated Markup Language in standards). The attestation reading, WITHOUT "agent", is canonical for every historical reference — it makes the superseded format a general attestation format rather than an agent-specific one, which matches what DEED became. The other two are to be corrected wherever they appear. 3. Drops the "Canonical copy: format-registrations/iana/a2ml-media-type.txt" line. That location exists nowhere: not as a directory (0 hits across standards, a2ml, deed-ecosystem and k9-ecosystem, against positive controls of 126/7/47/139 paths matching "k9"), and not as a repository (both hyperpolymath/ and metadatastician/ return 404, with a live positive control and a 404 negative control; no local checkout, against a control that found three "standards" checkouts by the same method). The same line is dropped from the vnd.deed and vnd.k9 registrations in hyperpolymath/standards, so all three layers agree. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QNjWX2B4FffG7zqMBMui6v
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Advanced Run ID: 📒 Files selected for processing (1)
Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review. 📜 Recent review details
|
| Layer / File(s) | Summary |
|---|---|
Historical registration status docs/iana/application-vnd.a2ml-registration.txt |
The header replaces submission details with the unsubmitted status, superseding registration link, historical provenance, and canonical A2ML expansion. |
Priority: ⬇️ Low
Estimated code review effort: 1 (Trivial) | ~3 minutes
Change: Other
Merge Risk: ⚪ Minimal · up to b3c6c
The documentation update is internally consistent, with no concrete merge-blocking risk identified.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
| Check name | Status | Explanation |
|---|---|---|
| Title check | ✅ Passed | The title clearly summarises the main changes: it marks application/vnd.a2ml as never submitted, superseded, and expands A2ML. |
| Description check | ✅ Passed | The description directly explains the documentation changes, their rationale, and the resulting registration guidance. |
| Docstring Coverage | ✅ Passed | No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0… |
| Linked Issues check | ✅ Passed | Check skipped because no linked issues were found for this pull request. |
| Out of Scope Changes check | ✅ Passed | Check skipped because no linked issues were found for this pull request. |
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
- Create stacked PR
- Commit on current branch
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.
A rabbit checks the media mark
The old draft rests within the archive
No submission crossed the IANA gate
A deed now names the current state
A2ML keeps its proper phrase
Comment @coderabbitai help to get the list of available commands.
|



What this does
Marks
docs/iana/application-vnd.a2ml-registration.txtas never submitted andsuperseded, so that nobody files it and nobody cites it as a registered type.
Confirmed by the change controller on 2026-09-14:
application/vnd.a2mlwasdrafted but never sent to IANA. It is therefore an unregistered media type
string — not reserved, not allocated, and it must not be described anywhere as a
registered type or as a registered alias.
Three consequences, all now stated in the file header:
draft that
application/vnd.deedwas derived from.standards/deed/docs/iana/application-vnd.deed-registration.txt, which is afresh registration rather than a change request precisely because this one
was never filed.
(RULED 2026-09-14). Three repositories each carried a different expansion —
Attested Agent Markup Language, Attestation Markup Language, Annotated Markup
Language — and the attestation reading, without "agent", is canonical for
every historical reference. The other two are to be corrected wherever they
appear.
The phantom
format-registrations/iana/...canonical-copy line is dropped heretoo: that location exists in no repository, so this file previously described
itself as a synchronised copy of an original that was never created. It lives
beside the specification it describes; there is no second copy.
🤖 Generated with Claude Code
https://claude.ai/code/session_01QNjWX2B4FffG7zqMBMui6v