Skip to content

Commit 753bcb3

Browse files
committed
Allow separate publication of registry tables into a separate document
1 parent ebd4c99 commit 753bcb3

File tree

1 file changed

+49
-5
lines changed

1 file changed

+49
-5
lines changed

index.bs

Lines changed: 49 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4077,11 +4077,21 @@ Publishing Registries</h4>
40774077
Include the [=registry definition=] for each of its [=registry tables=].
40784078

40794079
<li>
4080-
Include the entire contents of each [=registry table=],
4081-
either inline in the report
4082-
(e.g. formatted as a table, or list, or other appropriate representation),
4083-
or in a machine-readable file published as part of the [=technical report=],
4084-
or (preferably) both.
4080+
Provide the [=registry data=] by either:
4081+
<ul>
4082+
<li>
4083+
Including the entire contents of each [=registry table=],
4084+
either inline in the report
4085+
(e.g. formatted as a table, or list, or other appropriate representation),
4086+
or in a machine-readable file published as part of the [=technical report=],
4087+
or (preferably) both.
4088+
4089+
<li>
4090+
Linking to one or more standalone [=Registry Data Reports=]
4091+
containing the [=registry tables=]
4092+
in human-readable form, machine-readable form,
4093+
or (preferably) both.
4094+
</ul>
40854095

40864096
<li>
40874097
Include, if the [=registry table=] is provided in a machine-readable file,
@@ -4172,6 +4182,40 @@ Updating Registry Tables</h4>
41724182
which would not be allowed by the unamended [=registry definition=]
41734183
<em class=rfc2119>must</em> be identified as such.
41744184

4185+
<h4 id=reg-data-reports>
4186+
Registry Data Reports</h4>
4187+
4188+
When the [=registry data=] is published in a separate [=technical report=]
4189+
from its [=registry definition=],
4190+
that [=technical report|report=] is called a <dfn>Registry Data Report</dfn>.
4191+
This [=technical report=]:
4192+
<ul>
4193+
<li>
4194+
<em class=rfc2119>Must</em> link to the [=registry definition=]
4195+
establishing the [=registry tables=] that it contain.
4196+
4197+
<li>
4198+
<em class=rfc2119>May</em> contain informative introductory text, examples, and notes
4199+
about the [=registry tables=] and [=registry entries|entries=] that it contains.
4200+
(Changes to these parts are deemed to be [=editorial changes=]).
4201+
</ul>
4202+
4203+
[=Registry Data Reports=] do not have maturity levels in and of themselves;
4204+
The maturity level of the [=registry=] whose [=registry data|data=] they record
4205+
is that of the [=technical report=] holding the [=registry definition=].
4206+
4207+
Anytime a change is made to a [=registry definition=],
4208+
the Working Group <em class=rfc2119>must</em> update and republish
4209+
any document holding the corresponding [=registry tables=]
4210+
to make it consistent with these changes.
4211+
4212+
Given a recorded [=Group Decision=] to do so,
4213+
the [=Working Group=]
4214+
<em class=rfc2119>may</em> republish the [=Registry Data Report=] to incorporate
4215+
[=editorial changes=].
4216+
If there is no [=Working Group=] chartered to maintain this registry,
4217+
the [=Team=] <em class=rfc2119>may</em> do so instead.
4218+
41754219
<h4 id=reg-ref-specifications>
41764220
Specifications that Reference Registries</h4>
41774221

0 commit comments

Comments
 (0)