Skip to content

Commit fdf79eb

Browse files
Revise codec registration entry requirements
Updated registration entry requirements for codec strings and specifications.
1 parent ac7216c commit fdf79eb

File tree

1 file changed

+43
-34
lines changed

1 file changed

+43
-34
lines changed

codec_registry.src.html

Lines changed: 43 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -45,54 +45,61 @@
4545
Registration Entry Requirements {#registration-entry-requirements}
4646
==================================================================
4747

48-
1. Each entry must include a unique <a>codec string</a>, a common name string, and a
49-
link to the codec's specification.
50-
2. The <a>codec string</a> must be crafted as follows:
48+
To register an entry, file an issue in the
49+
[WebCodecs GitHub issue tracker](https://github.com/w3c/webcodecs/issues/)
50+
so it can be discussed and evaluated for compliance before being added to
51+
the registry.
52+
53+
The Media Working Group might seek expertise from outside the
54+
Working Group as part of its evaluation, e.g., from the codec specification
55+
editors or relevant standards group. If the codec specification is not
56+
publicly available, it must be made available to the Working Group for
57+
evaluation. For the entry to be included, there needs
58+
to be interest from at least one implementer in the Working Group. If the Working Group
59+
reaches consensus to accept the candidate entry, send a pull request (either by editors
60+
or by the part requesting the candidate registration) that meets the following requirements:
61+
62+
1. A unique <a>codec string</a>, a common name string, and a
63+
link to the codec's public <dfn>registration specification</dfn>.
64+
2. The <a>codec string</a> requirements are as follows:
5165
1. If the <a>codec string</a> contains a fixed prefix with variable suffix values,
5266
the suffix must be represented by an asterisk and the registration's
53-
public specification must describe how to fully qualify the variable
67+
public specification needs to describe how to fully qualify the variable
5468
portion of the string.
5569
2. Otherwise, if the codec is recognized by multiple strings, a single
5670
preferred string should be listed and the registration's specification
5771
must list the other allowed strings.
5872
3. Otherwise, the codec is identified by a simple fixed string.
5973
3. Each registration's specification must include a sequence of sections
6074
describing:
61-
1. Recognized codec strings
62-
2. {{EncodedAudioChunk}} or {{EncodedVideoChunk}} internal data
63-
3. {{AudioDecoderConfig}} or {{VideoDecoderConfig}} description bytes
75+
1. Recognized codec strings.
76+
2. {{EncodedAudioChunk}} or {{EncodedVideoChunk}} internal data.
77+
3. {{AudioDecoderConfig}} or {{VideoDecoderConfig}} description bytes.
6478
4. Expectations for {{EncodedAudioChunk}} or {{EncodedVideoChunk}}
65-
{{EncodedVideoChunk/[[type]]}}
79+
{{EncodedVideoChunk/[[type]]}}.
6680
4. Where applicable, a registration specification may include a section
6781
describing extensions to {{VideoEncoderConfig}} or {{AudioEncoderConfig}}
6882
dictionaries.
69-
5. Candidate entries must be announced by filing an issue in the
70-
[WebCodecs GitHub issue tracker](https://github.com/w3c/webcodecs/issues/)
71-
so they can be discussed and evaluated for compliance before being added to
72-
the registry. The Media Working Group may seek expertise from outside the
73-
Working Group as part of its evaluation, e.g., from the codec specification
74-
editors or relevant standards group. If the codec specification is not
75-
publicly available, it must be made available to the Working Group for
76-
evaluation. If the Working Group reaches consensus to accept the candidate,
77-
a pull request should be drafted (either by editors or by the party
78-
requesting the candidate registration) to register the candidate.
79-
The registry editors will review and merge the pull request.
80-
6. Existing entries cannot be deleted or deprecated. They may be changed after
81-
being published through the same process as candidate entries. Possible
82-
changes include expansion of the <a>codec string</a> to better qualify the codec,
83-
adjustments to the codec name string, and modification of the link to the
84-
codec's specification.
8583

84+
Once consensus is reached by the Working Group, the registry editors will review and merge the pull request.
85+
86+
Existing entries cannot be deleted or deprecated. They may be changed after
87+
being published through the same process as candidate entries. Possible
88+
changes include expansion of the <a>codec string</a> to better qualify the codec,
89+
adjustments to the codec name string, and modification of the link to the
90+
codec's specification.
8691

8792
Audio Codec Registry {#audio-codec-registry}
8893
============================================
8994

9095
<table class='data'>
91-
<tr>
92-
<td>**codec string**</td>
93-
<td>**common name**</td>
94-
<td>**public specification**</td>
95-
</tr>
96+
<thead>
97+
<tr>
98+
<th>Codec string</th>
99+
<th>Common name</th>
100+
<th>Registration specification</th>
101+
</tr>
102+
</thead>
96103
<tr>
97104
<td>flac</td>
98105
<td>Flac</td>
@@ -153,11 +160,13 @@
153160
============================================
154161

155162
<table class='data'>
156-
<tr>
157-
<td>**codec string**</td>
158-
<td>**common name**</td>
159-
<td>**specification**</td>
160-
</tr>
163+
<thead>
164+
<tr>
165+
<th>Codec string</th>
166+
<th>Common name</th>
167+
<th>Registration specification</th>
168+
</tr>
169+
</thead>
161170
<tr>
162171
<td>av01.\*</td>
163172
<td>AV1</td>

0 commit comments

Comments
 (0)