Skip to content

docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name - #4

Merged
hyperpolymath merged 1 commit into
mainfrom
docs/iana-a2ml-never-submitted
Sep 15, 2026
Merged

hyperpolymath merged 1 commit into
mainfrom
docs/iana-a2ml-never-submitted

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

What this does

Marks docs/iana/application-vnd.a2ml-registration.txt as never submitted and
superseded
, so that nobody files it and nobody cites it as a registered type.

Confirmed by the change controller on 2026-09-14: application/vnd.a2ml was
drafted 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:

  1. A do-not-file banner. The document is retained only as the historical
    draft that application/vnd.deed was derived from.
  2. A pointer to the real registration
    standards/deed/docs/iana/application-vnd.deed-registration.txt, which is a
    fresh registration rather than a change request precisely because this one
    was never filed.
  3. The expansion ruling. "A2ML" expands to "Attestation Markup Language"
    (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 here
too: 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

…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
@coderabbitai

coderabbitai Bot commented Sep 15, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Advanced

Run ID: c0a96939-ee8b-428e-bd43-916c7c1938e0

📥 Commits

Reviewing files that changed from the base of the PR and between 993e116 and b3c6c1d.

📒 Files selected for processing (1)
  • docs/iana/application-vnd.a2ml-registration.txt

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

📜 Recent review details
⚠️ CI failures not shown inline (6)

GitHub Actions: ReScript Tests / 0_test.txt: docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name

Conclusion: failure

View job details

##[group]Run deno install
 �[36;1mdeno install�[0m
 shell: /usr/bin/bash -e {0}
 ##[endgroup]
 ##[error]An error occurred trying to start process '/usr/bin/bash' with working directory '/home/runner/work/deed-core/deed-core/prototype/rescript'. No such file or directory

GitHub Actions: Idris2 Tests / 0_test.txt: docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name

Conclusion: failure

View job details

##[group]Run if [ ! -f ~/.idris2/bin/idris2 ]; then
 �[36;1mif [ ! -f ~/.idris2/bin/idris2 ]; then�[0m
 �[36;1m  echo "Installing Idris2 0.7.0..."�[0m
 �[36;1m  curl -L https://github.com/idris-lang/Idris2/releases/download/v0.7.0/idris2-0.7.0-x86_64-linux.tar.gz -o idris2.tar.gz�[0m
 �[36;1m  tar xf idris2.tar.gz�[0m
 �[36;1m  cd idris2-0.7.0�[0m
 �[36;1m  PREFIX=$HOME/.idris2 make install�[0m
 �[36;1mfi�[0m
 �[36;1mecho "$HOME/.idris2/bin" >> $GITHUB_PATH�[0m
 shell: /usr/bin/bash -e {0}
 ##[endgroup]
 Installing Idris2 0.7.0...
   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                  Dload  Upload   Total   Spent    Left  Speed
   0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
 100     9  100     9    0     0     56      0 --:--:-- --:--:-- --:--:--    56
 tar: This does not look like a tar archive
 gzip: stdin: not in gzip format
 tar: Child returned status 1
 tar: Error is not recoverable: exiting now
 ##[error]Process completed with exit code 2.

GitHub Actions: ReScript Tests / test: docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name

Conclusion: failure

View job details

##[group]Run deno install
 �[36;1mdeno install�[0m
 shell: /usr/bin/bash -e {0}
 ##[endgroup]
 ##[error]An error occurred trying to start process '/usr/bin/bash' with working directory '/home/runner/work/deed-core/deed-core/prototype/rescript'. No such file or directory

GitHub Actions: Fuzzing / 0_fuzzing.txt: docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name

Conclusion: failure

View job details

##[group]Run deno install
 �[36;1mdeno install�[0m
 shell: /usr/bin/bash -e {0}
 ##[endgroup]
 ##[error]An error occurred trying to start process '/usr/bin/bash' with working directory '/home/runner/work/deed-core/deed-core/prototype/rescript'. No such file or directory

GitHub Actions: Idris2 Tests / test: docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name

Conclusion: failure

View job details

##[group]Run if [ ! -f ~/.idris2/bin/idris2 ]; then
 �[36;1mif [ ! -f ~/.idris2/bin/idris2 ]; then�[0m
 �[36;1m  echo "Installing Idris2 0.7.0..."�[0m
 �[36;1m  curl -L https://github.com/idris-lang/Idris2/releases/download/v0.7.0/idris2-0.7.0-x86_64-linux.tar.gz -o idris2.tar.gz�[0m
 �[36;1m  tar xf idris2.tar.gz�[0m
 �[36;1m  cd idris2-0.7.0�[0m
 �[36;1m  PREFIX=$HOME/.idris2 make install�[0m
 �[36;1mfi�[0m
 �[36;1mecho "$HOME/.idris2/bin" >> $GITHUB_PATH�[0m
 shell: /usr/bin/bash -e {0}
 ##[endgroup]
 Installing Idris2 0.7.0...
   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                  Dload  Upload   Total   Spent    Left  Speed
   0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
 100     9  100     9    0     0     56      0 --:--:-- --:--:-- --:--:--    56
 tar: This does not look like a tar archive
 gzip: stdin: not in gzip format
 tar: Child returned status 1
 tar: Error is not recoverable: exiting now
 ##[error]Process completed with exit code 2.

GitHub Actions: Fuzzing / fuzzing: docs(iana): mark vnd.a2ml as never submitted, superseded, and expand the name

Conclusion: failure

View job details

##[group]Run deno install
 �[36;1mdeno install�[0m
 shell: /usr/bin/bash -e {0}
 ##[endgroup]
 ##[error]An error occurred trying to start process '/usr/bin/bash' with working directory '/home/runner/work/deed-core/deed-core/prototype/rescript'. No such file or directory

📝 Summary

Summary by CodeRabbit

  • Documentation
    • Updated the historical application/vnd.a2ml media type record to clarify that it was never submitted to IANA.
    • Recorded that the media type is superseded by application/vnd.deed.
    • Clarified the canonical expansion of A2ML and updated the document’s preparation details.

Walkthrough

The IANA media type record now states that application/vnd.a2ml was not submitted, is superseded by application/vnd.deed, and remains as historical source material.

Changes

IANA record correction

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.

❤️ Share

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.

@sonarqubecloud

Copy link
Copy Markdown

@hyperpolymath
hyperpolymath merged commit faabfd9 into main Sep 15, 2026
3 of 6 checks passed
@hyperpolymath
hyperpolymath deleted the docs/iana-a2ml-never-submitted branch September 15, 2026 18:29
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