|
5 | 5 | <title>Web Platform Design Principles</title>
|
6 | 6 | <meta content="NOTE-ED" name="w3c-status">
|
7 | 7 | <link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
|
8 |
| - <meta content="Bikeshed version 60c422380, updated Thu Feb 20 19:11:22 2025 -0800" name="generator"> |
| 8 | + <meta content="Bikeshed version b25686b9f, updated Fri Mar 14 14:15:20 2025 -0700" name="generator"> |
9 | 9 | <link href="https://www.w3.org/TR/design-principles/" rel="canonical">
|
10 | 10 | <link href="https://www.w3.org/2008/site/images/favicon.ico" rel="icon">
|
11 |
| - <meta content="8039864795cd2abcee191d6776bf36774fd0a46d" name="revision"> |
| 11 | + <meta content="7861814970a0db1e1295600b5ffa6cc63bab4622" name="revision"> |
12 | 12 | <meta content="dark light" name="color-scheme">
|
13 | 13 | <link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
|
14 | 14 | <style>
|
|
702 | 702 | <div class="head">
|
703 | 703 | <p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
|
704 | 704 | <h1 class="p-name no-ref" id="title">Web Platform Design Principles</h1>
|
705 |
| - <p id="w3c-state"><a href="https://www.w3.org/standards/types/#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2025-03-06">6 March 2025</time></p> |
| 705 | + <p id="w3c-state"><a href="https://www.w3.org/standards/types/#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2025-03-25">25 March 2025</time></p> |
706 | 706 | <details open>
|
707 | 707 | <summary>More details about this document</summary>
|
708 | 708 | <div data-fill-with="spec-metadata">
|
@@ -741,7 +741,7 @@ <h2 class="no-num no-toc no-ref heading settled" id="sotd"><span class="content"
|
741 | 741 | <p> <em>This section describes the status of this document at the time of its
|
742 | 742 | publication. A list of current <abbr title="World Wide Web Consortium">W3C</abbr> publications and the
|
743 | 743 | latest revision of this technical report can be found in the <a href="https://www.w3.org/TR/"><abbr title="World Wide Web
|
744 |
| - Consortium">W3C</abbr> technical reports index</a> at https://www.w3.org/TR/.</em> </p> |
| 744 | + Consortium">W3C</abbr> standards and drafts index</a> at https://www.w3.org/TR/.</em> </p> |
745 | 745 | <p> This document was published by the <a href="https://www.w3.org/groups/other/tag/">Technical Architecture Group</a> as an Editor’s Draft intended for the Note track.
|
746 | 746 | This is a draft document and
|
747 | 747 | may be updated, replaced or obsoleted by other documents at any time.
|
@@ -1134,7 +1134,7 @@ <h3 class="heading settled" data-level="1.6" id="devices-platforms"><span class=
|
1134 | 1134 | <h3 class="heading settled" data-level="1.7" id="new-features"><span class="secno">1.7. </span><span class="content">Add new capabilities with care</span><a class="self-link" href="#new-features"></a></h3>
|
1135 | 1135 | <p>Add new capabilities to the web with consideration of existing functionality and content.</p>
|
1136 | 1136 | <p>The Web includes many extension points that allow for additions;
|
1137 |
| -see for example <a href="https://html.spec.whatwg.org/multipage/introduction.html#extensibility"><cite>HTML</cite> § 1.7.3 Extensibility</a>.</p> |
| 1137 | +see for example <a href="https://html.spec.whatwg.org/multipage/introduction.html#extensibility"><cite>HTML</cite> § 1.7.2 Extensibility</a>.</p> |
1138 | 1138 | <p>Before adding items, consider integration with existing, similar capabilities.
|
1139 | 1139 | If this leads to a preferred design approach that cannot be implemented by only adding items,
|
1140 | 1140 | it might still be possible; see <a href="#removing-features">§ 1.8 Remove or change capabilities only once you understand existing usage</a>.</p>
|
@@ -2170,7 +2170,7 @@ <h3 class="heading settled" data-level="6.3" id="attributes-vs-methods"><span cl
|
2170 | 2170 | <p>If static, then return a new object each time.
|
2171 | 2171 | In which case, this should be be a method.</p>
|
2172 | 2172 | </ul>
|
2173 |
| - <h3 class="heading settled" data-level="6.4" id="prefer-dictionaries"><span class="secno">6.4. </span><span class="content">Accept optional and/or primitive arguments through dictionaries</span><span id="prefer-dict-to-bool"></span><a class="self-link" href="#prefer-dictionaries"></a></h3> |
| 2173 | + <h3 class="heading settled" data-level="6.4" id="prefer-dictionaries"><span class="secno">6.4. </span><span class="bs-old-id" id="prefer-dict-to-bool"></span><span class="content">Accept optional and/or primitive arguments through dictionaries</span><a class="self-link" href="#prefer-dictionaries"></a></h3> |
2174 | 2174 | <p>API methods should generally use dictionary arguments
|
2175 | 2175 | instead of a series of optional arguments.</p>
|
2176 | 2176 | <p>This makes the code that calls the method more readable,
|
@@ -4509,7 +4509,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
|
4509 | 4509 | <dt id="biblio-fetch">[FETCH]
|
4510 | 4510 | <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>
|
4511 | 4511 | <dt id="biblio-fingerprinting-guidance">[FINGERPRINTING-GUIDANCE]
|
4512 |
| - <dd>Nick Doty. <a href="https://w3c.github.io/fingerprinting-guidance/"><cite>Mitigating Browser Fingerprinting in Web Specifications</cite></a>. URL: <a href="https://w3c.github.io/fingerprinting-guidance/">https://w3c.github.io/fingerprinting-guidance/</a> |
| 4512 | + <dd>Nick Doty; Tom Ritter. <a href="https://w3c.github.io/fingerprinting-guidance/"><cite>Mitigating Browser Fingerprinting in Web Specifications</cite></a>. URL: <a href="https://w3c.github.io/fingerprinting-guidance/">https://w3c.github.io/fingerprinting-guidance/</a> |
4513 | 4513 | <dt id="biblio-highres-time">[HIGHRES-TIME]
|
4514 | 4514 | <dd>Yoav Weiss. <a href="https://w3c.github.io/hr-time/"><cite>High Resolution Time</cite></a>. URL: <a href="https://w3c.github.io/hr-time/">https://w3c.github.io/hr-time/</a>
|
4515 | 4515 | <dt id="biblio-html">[HTML]
|
|
0 commit comments