Skip to content
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

Use <code> for references to a CDDL type #455

Merged
merged 2 commits into from
Dec 19, 2024
Merged

Conversation

tidoust
Copy link
Member

@tidoust tidoust commented Dec 19, 2024

The spec wrapped the CDDL result type of the Set Permission command in a <pre class="cddl"> block, even though the return type is actually a reference to a CDDL type defined in WebDriver BiDi.

This update wraps the block into <code> instead, following similar conventions used for IDL.

Context for the request is that CDDL definitions defined in specs are now extracted and exposed in Webref to ease validation and integration in tools: https://github.com/w3c/webref/tree/main/ed/cddl


Preview | Diff

The spec wrapped the CDDL result type of the Set Permission command in a
`<pre class="cddl">` block, even though the return type is actually a reference
to a CDDL type defined in WebDriver BiDi.

This update wraps the block into `<code>` instead, following similar
conventions used for IDL.

Context for the request is that CDDL definitions defined in specs are now
extracted and exposed in Webref to ease validation and integration in tools:
https://github.com/w3c/webref/tree/main/ed/cddl
The quotes are now included in the definition.
@@ -1788,7 +1788,7 @@ <h2>
</tr>
<tr data-cite="orientation-event">
<td class="string-token">
"[=accelerometer=]"
[="accelerometer"=]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems weird to me to have the quotes be part of the definition, but I see that's what they did. 🤷

@miketaylr miketaylr merged commit c9c9c75 into w3c:main Dec 19, 2024
2 checks passed
github-actions bot added a commit that referenced this pull request Dec 19, 2024
SHA: c9c9c75
Reason: push, by miketaylr

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
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.

3 participants