|
8 | 8 | <meta content="Bikeshed version 60c422380, updated Thu Feb 20 19:11:22 2025 -0800" 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="beaaef9c35bb4bac8f9956d726ee39894fc0c483" name="revision"> |
| 11 | + <meta content="8039864795cd2abcee191d6776bf36774fd0a46d" 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-04">4 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-06">6 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">
|
@@ -3819,9 +3819,9 @@ <h4 class="no-num no-toc heading settled" id="naming-inclusive"><span class="con
|
3819 | 3819 | For example, "A user may wish to adjust their preferences".</p>
|
3820 | 3820 | <h3 class="heading settled" data-level="12.4" id="naming-future-proofing"><span class="secno">12.4. </span><span class="content">Use names that describe a purpose</span><a class="self-link" href="#naming-future-proofing"></a></h3>
|
3821 | 3821 | <p>Name things for what they do, not how they do it.</p>
|
3822 |
| - <p>Names that reflect the purpose of their subject |
| 3822 | + <p>Names that reflect a purpose |
3823 | 3823 | are more likely to be future-proof. <a href="#removing-features">Removing APIs from the web is difficult</a>,
|
3824 |
| -so names need to outlast details.</p> |
| 3824 | +so names need to outlast any implementation detail.</p> |
3825 | 3825 | <p>In particular,
|
3826 | 3826 | names should avoid the use of
|
3827 | 3827 | code names,
|
@@ -4535,7 +4535,7 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
|
4535 | 4535 | <dt id="biblio-rfc9205">[RFC9205]
|
4536 | 4536 | <dd>M. Nottingham. <a href="https://httpwg.org/specs/rfc9205.html"><cite>Building Protocols with HTTP</cite></a>. June 2022. Best Current Practice. URL: <a href="https://httpwg.org/specs/rfc9205.html">https://httpwg.org/specs/rfc9205.html</a>
|
4537 | 4537 | <dt id="biblio-service-workers">[SERVICE-WORKERS]
|
4538 |
| - <dd>Jake Archibald; Marijn Kruisselbrink. <a href="https://w3c.github.io/ServiceWorker/"><cite>Service Workers</cite></a>. URL: <a href="https://w3c.github.io/ServiceWorker/">https://w3c.github.io/ServiceWorker/</a> |
| 4538 | + <dd>Yoshisato Yanagisawa; Monica CHINTALA. <a href="https://w3c.github.io/ServiceWorker/"><cite>Service Workers</cite></a>. URL: <a href="https://w3c.github.io/ServiceWorker/">https://w3c.github.io/ServiceWorker/</a> |
4539 | 4539 | <dt id="biblio-url">[URL]
|
4540 | 4540 | <dd>Anne van Kesteren. <a href="https://url.spec.whatwg.org/"><cite>URL Standard</cite></a>. Living Standard. URL: <a href="https://url.spec.whatwg.org/">https://url.spec.whatwg.org/</a>
|
4541 | 4541 | <dt id="biblio-web-animations-2">[WEB-ANIMATIONS-2]
|
|
0 commit comments