Skip to content

Editorial fixes to media types section. #1062

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 15, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 26 additions & 25 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3413,37 +3413,38 @@ <h3>Syntactic Sugar</h3>
<h3>Media Types</h3>

<p>
Media types as defined in [[RFC6838]] serve a useful purpose with verifiable
credentials, especially regarding identification of a particular syntax that is
in use with a verifiable credential.
Media types, as defined in [[RFC6838]], identify the syntax used to express a
<a>verifiable credential</a> as well as other useful processing guidelines.
</p>
<p>
Syntaxes SHOULD be identified by a media type, and certain conventions as
outlined in this section SHOULD be followed when defining or using media types
with verifiable credentials.
Syntaxes used to express the data model in this specification SHOULD be
identified by a media type, and conventions outlined in this section SHOULD be
followed when defining or using media types with <a>verifiable credentials</a>.
</p>
<p>
Any media types associated with the core data model are listed in the section on
<a href="#iana-considerations">IANA Considerations</a> for registration with
IANA.
Any media types associated with the core data model are listed in the Section
<a href="#iana-considerations"></a>.
</p>
<p class="issue" data-number="1060">
Presence of the term "verifiable" (or a shortened version) in the media type may
or may not imply a proof. Original proposed language is tracked in the issue
corresponding to this note.
</p>
<p>
Use of the term `credential` in a media type related to a syntax of verifiable
credentials <i>without</i> the corresponding use of `verifiable` as described
above <i>does not</i> imply the presence of a proof with the
<a href="#dfn-credential">credential</a>.
</p>
<p>
At the time of this writing, there is one media type associated with the core
data model: `application/credential+ld+json`. Other specifications such as
[[VC-JWT]] define additional media types as may be required to allow for proper
interpretation of the syntax of verifiable credentials encoded in the syntax
described by the respective specification.
The VCWG is currently discussing whether the presence of the term "verifiable"
(or a shortened version) in the media type may or may not imply a proof. The
Working Group is seeking implementation experience related to the use of media
types and the expectation related to whether or not a particular media type
is expected to be secure with a particular proof.
</p>
<p class="issue" data-number="1065">
The VCWG is currently debating whether all media types that start with
`application/vc+` indicate an expectation around the securing mechanism or not.
Working Group is seeking implementation experience related to the use of media
types and the expectation related to whether or not a particular media type
is expected to be secure with a particular proof.
</p>
<p>
There is one media type associated with the core data model:
`application/vc+ld+json`. Other specifications, such as [[?VC-JWT]],
define other media types that contain transformation rules that allow for
those other syntaxes to be transformed to the `application/vc+ld+json`
media type.
</p>
</section>

Expand Down