Skip to content

Requalify "Informative References" into Non-Normative #3104

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.

Sign up for GitHub

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

Open
frivoal wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Requalify "Informative References" into Non-Normative #3104

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
2 changes: 1 addition & 1 deletion bikeshed/boilerplate.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1205,7 +1205,7 @@ def addReferencesSection(doc: t.SpecT) -> None:
container,
h.E.h3(
{"class": "no-num no-ref", "id": h.safeID(doc, "informative")},
_t("Informative References"),
_t("Non-Normative References"),
),
h.E.dl(),
)
Expand Down
2 changes: 1 addition & 1 deletion bikeshed/translate/messages.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ msgid "Normative References"
msgstr ""

#: bikeshed/boilerplate.py:1187
msgid "Informative References"
msgid "Non-Normative References"
msgstr ""

#: bikeshed/boilerplate.py:1215
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio001.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -432,7 +432,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -458,7 +458,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-normative">[NORMATIVE]
<dd>alice; bob. <a href="https://example.test/bar/"><cite>Bar Level 1</cite></a>. REC. URL: <a href="https://example.test/bar/">https://example.test/bar/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-alias-of-something-else">[ALIAS-OF-SOMETHING-ELSE]
<dd>I'm something else string-based.
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio002.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<li>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -442,7 +442,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<p><a data-biblio-display="direct" data-link-type="biblio" href="https://datatracker.ietf.org/doc/html/rfc2119" title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</a></p>
</main>
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span></h2>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-rfc2119">[RFC2119]
<dd>S. Bradner. <a href="https://datatracker.ietf.org/doc/html/rfc2119"><cite>Key words for use in RFCs to Indicate Requirement Levels</cite></a>. March 1997. Best Current Practice. URL: <a href="https://datatracker.ietf.org/doc/html/rfc2119">https://datatracker.ietf.org/doc/html/rfc2119</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio003.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<li>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -442,7 +442,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<p><a data-biblio-display="direct" data-link-type="biblio" href="https://datatracker.ietf.org/doc/html/rfc2119" title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</a></p>
</main>
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span></h2>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-rfc2119">[RFC2119]
<dd>S. Bradner. <a href="https://datatracker.ietf.org/doc/html/rfc2119"><cite>Key words for use in RFCs to Indicate Requirement Levels</cite></a>. March 1997. Best Current Practice. URL: <a href="https://datatracker.ietf.org/doc/html/rfc2119">https://datatracker.ietf.org/doc/html/rfc2119</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio004.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<li>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -442,7 +442,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<p><a data-biblio-display="direct" data-link-type="biblio" href="https://datatracker.ietf.org/doc/html/rfc2119" title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</a></p>
</main>
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span></h2>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-rfc2119">[RFC2119]
<dd>S. Bradner. <a href="https://datatracker.ietf.org/doc/html/rfc2119"><cite>Key words for use in RFCs to Indicate Requirement Levels</cite></a>. March 1997. Best Current Practice. URL: <a href="https://datatracker.ietf.org/doc/html/rfc2119">https://datatracker.ietf.org/doc/html/rfc2119</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio005.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<li>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -442,7 +442,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<p><a data-biblio-display="direct" data-link-type="biblio" href="https://datatracker.ietf.org/doc/html/rfc2119" title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</a></p>
</main>
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span></h2>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-rfc2119">[RFC2119]
<dd>S. Bradner. <a href="https://datatracker.ietf.org/doc/html/rfc2119"><cite>Key words for use in RFCs to Indicate Requirement Levels</cite></a>. March 1997. Best Current Practice. URL: <a href="https://datatracker.ietf.org/doc/html/rfc2119">https://datatracker.ietf.org/doc/html/rfc2119</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio006.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<li>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -440,7 +440,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<p><a data-biblio-obsolete data-link-type="biblio" href="#biblio-dom-level-2-style" title="Document Object Model (DOM) Level 2 Style Specification">[dom-level-2-style]</a></p>
</main>
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span></h2>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-dom-level-2-style">[DOM-LEVEL-2-STYLE]
<dd>Chris Wilson; Philippe Le Hegaret. <a href="https://www.w3.org/TR/DOM-Level-2-Style/"><cite>Document Object Model (DOM) Level 2 Style Specification</cite></a>. 3 November 2020. REC. URL: <a href="https://www.w3.org/TR/DOM-Level-2-Style/">https://www.w3.org/TR/DOM-Level-2-Style/</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/biblio007.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<li>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
</ol>
</nav>
Expand All @@ -441,7 +441,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<p><a data-biblio-display="inline" data-link-type="biblio" href="#biblio-jis4051">not sure why inline is useful on a document without a URL, but hey, the syntax’s there, so it might as well work</a></p>
</main>
<h2 class="no-num no-ref heading settled" id="references"><span class="content">References</span></h2>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span></h3>
<dl>
<dt id="biblio-jis4051">[JIS4051]
<dd><cite>Formatting rules for Japanese documents (『日本語文書の組版方法』).</cite> Japanese Standards Association. 2004. JIS X 4051:2004. In Japanese
Expand Down
4 changes: 2 additions & 2 deletions tests/github/WICG/aom/spec/custom-element-semantics.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -766,7 +766,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
<li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a>
</ol>
Expand Down Expand Up @@ -1143,7 +1143,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-webidl">[WEBIDL]
<dd>Edgar Chen; Timothy Gu. <a href="https://webidl.spec.whatwg.org/"><cite>Web IDL Standard</cite></a>. Living Standard. URL: <a href="https://webidl.spec.whatwg.org/">https://webidl.spec.whatwg.org/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-infra">[INFRA]
<dd>Anne van Kesteren; Domenic Denicola. <a href="https://infra.spec.whatwg.org/"><cite>Infra Standard</cite></a>. Living Standard. URL: <a href="https://infra.spec.whatwg.org/">https://infra.spec.whatwg.org/</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/github/WICG/app-history/spec.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -862,7 +862,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
<li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a>
</ol>
Expand Down Expand Up @@ -1835,7 +1835,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-xhr">[XHR]
<dd>Anne van Kesteren. <a href="https://xhr.spec.whatwg.org/"><cite>XMLHttpRequest Standard</cite></a>. Living Standard. URL: <a href="https://xhr.spec.whatwg.org/">https://xhr.spec.whatwg.org/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-csp">[CSP]
<dd>Mike West; Antonio Sartori. <a href="https://w3c.github.io/webappsec-csp/"><cite>Content Security Policy Level 3</cite></a>. URL: <a href="https://w3c.github.io/webappsec-csp/">https://w3c.github.io/webappsec-csp/</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/github/WICG/compression/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -976,7 +976,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
<li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a>
</ol>
Expand Down Expand Up @@ -1265,7 +1265,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-whatwg-streams">[WHATWG-STREAMS]
<dd>Adam Rice; et al. <a href="https://streams.spec.whatwg.org/"><cite>Streams Standard</cite></a>. Living Standard. URL: <a href="https://streams.spec.whatwg.org/">https://streams.spec.whatwg.org/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-rfc7230">[RFC7230]
<dd>R. Fielding, Ed.; M. Nottingham, Ed.; J. Reschke, Ed.. <a href="https://httpwg.org/specs/rfc9112.html"><cite>HTTP/1.1</cite></a>. June 2022. Internet Standard. URL: <a href="https://httpwg.org/specs/rfc9112.html">https://httpwg.org/specs/rfc9112.html</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/github/WICG/construct-stylesheets/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2219,7 +2219,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
<li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a>
</ol>
Expand Down Expand Up @@ -2683,7 +2683,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-webidl">[WEBIDL]
<dd>Edgar Chen; Timothy Gu. <a href="https://webidl.spec.whatwg.org/"><cite>Web IDL Standard</cite></a>. Living Standard. URL: <a href="https://webidl.spec.whatwg.org/">https://webidl.spec.whatwg.org/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-fetch">[FETCH]
<dd>Anne van Kesteren. <a href="https://fetch.spec.whatwg.org/"><cite>Fetch Standard</cite></a>. Living Standard. URL: <a href="https://fetch.spec.whatwg.org/">https://fetch.spec.whatwg.org/</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/github/WICG/contact-api/spec/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1034,7 +1034,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
<li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a>
</ol>
Expand Down Expand Up @@ -1520,7 +1520,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-webidl">[WEBIDL]
<dd>Edgar Chen; Timothy Gu. <a href="https://webidl.spec.whatwg.org/"><cite>Web IDL Standard</cite></a>. Living Standard. URL: <a href="https://webidl.spec.whatwg.org/">https://webidl.spec.whatwg.org/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-mimesniff">[MIMESNIFF]
<dd>Gordon P. Hemsley. <a href="https://mimesniff.spec.whatwg.org/"><cite>MIME Sniffing Standard</cite></a>. Living Standard. URL: <a href="https://mimesniff.spec.whatwg.org/">https://mimesniff.spec.whatwg.org/</a>
Expand Down
4 changes: 2 additions & 2 deletions tests/github/WICG/cookie-store/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -877,7 +877,7 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
<a href="#references"><span class="secno"></span> <span class="content">References</span></a>
<ol class="toc">
<li><a href="#normative"><span class="secno"></span> <span class="content">Normative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Informative References</span></a>
<li><a href="#informative"><span class="secno"></span> <span class="content">Non-Normative References</span></a>
</ol>
<li><a href="#idl-index"><span class="secno"></span> <span class="content">IDL Index</span></a>
</ol>
Expand Down Expand Up @@ -2406,7 +2406,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dt id="biblio-webidl">[WEBIDL]
<dd>Edgar Chen; Timothy Gu. <a href="https://webidl.spec.whatwg.org/"><cite>Web IDL Standard</cite></a>. Living Standard. URL: <a href="https://webidl.spec.whatwg.org/">https://webidl.spec.whatwg.org/</a>
</dl>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Informative References</span><a class="self-link" href="#informative"></a></h3>
<h3 class="no-num no-ref heading settled" id="informative"><span class="content">Non-Normative References</span><a class="self-link" href="#informative"></a></h3>
<dl>
<dt id="biblio-ecmascript">[ECMAScript]
<dd><a href="https://tc39.es/ecma262/multipage/"><cite>ECMAScript Language Specification</cite></a>. URL: <a href="https://tc39.es/ecma262/multipage/">https://tc39.es/ecma262/multipage/</a>
Expand Down
Loading
Loading