fix: terminology alignment and ADR 0007/0010 follow-ups#79
Open
liady wants to merge 1 commit into
Open
Conversation
| This document defines the **AI Catalog**: a typed, nestable JSON | ||
| container for discovering heterogeneous AI artifacts. Each entry | ||
| declares its artifact type via a media type and may reference or | ||
| declares its artifact type via a type identifier and may reference or |
Contributor
There was a problem hiding this comment.
The value of type is still an IANA media type. We are sticking with this value domain because then we don't need to define our own syntax and range of valid values. There is precedence for using type as an indicator of media type in the IETF Web Linking specification https://datatracker.ietf.org/doc/html/rfc8288#section-3.4.1
| manifest, an A2A agent card, a Claude Code plugin, a | ||
| dataset descriptor, or a nested AI Catalog. | ||
|
|
||
| AI Card |
Contributor
There was a problem hiding this comment.
I'm not sure we really want to keep the terminology of AI Card. The repo was renamed and the org hasn't been changed primarily because we didn't want to break links. We have been using "catalog entry" as the primary term.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #72.
Four small alignment items, none of them changing behavior on their own:
typeprecisely because it is an open type identifier, and the field definition already uses that framing, so the intro material now matches.application/ai-catalog+jsonresponses, while Location Independence makes serving that media type a SHOULD. A catalog served asapplication/jsonwould pass the well-known flow but fail the link-relation flow. Step 4 now accepts generic JSON media types as long as the document has a validspecVersion.urlacross all objects, but the spec usesuriwhere non-fetchable identifiers are allowed (attestationuri,governanceUri,registryUri,statementUri). Added an update note to the ADR recording that the split is deliberate, so implementers don't read it as drift.