Add new spec: design-principles

[jyasskin]

URL

https://www.w3.org/TR/design-principles/

Rationale

So that specs can refer to sections in the design principles to justify their own decisions. There are also a few definitions here, although arguably those should actually be in more-normative specifications.

Additional properties

{}

[browser-specs-bot]

Changes to index.json

This update would trigger the following changes in index.json:

Add spec (1)

{
  "url": "https://www.w3.org/TR/design-principles/",
  "seriesComposition": "full",
  "shortname": "design-principles",
  "series": {
    "shortname": "design-principles",
    "currentSpecification": "design-principles",
    "title": "Web Platform Design Principles",
    "shortTitle": "Web Platform Design Principles",
    "releaseUrl": "https://www.w3.org/TR/design-principles/",
    "nightlyUrl": "https://w3ctag.github.io/design-principles/"
  },
  "organization": "W3C",
  "groups": [
    {
      "name": "Technical Architecture Group",
      "url": "https://www.w3.org/2001/tag/"
    }
  ],
  "release": {
    "url": "https://www.w3.org/TR/design-principles/",
    "status": "Note",
    "filename": "Overview.html"
  },
  "nightly": {
    "url": "https://w3ctag.github.io/design-principles/",
    "status": "Editor's Draft",
    "alternateUrls": [],
    "repository": "https://github.com/w3ctag/design-principles",
    "sourcePath": "index.bs",
    "filename": "index.html"
  },
  "title": "Web Platform Design Principles",
  "source": "w3c",
  "shortTitle": "Web Platform Design Principles",
  "categories": [],
  "standing": "good"
}

Tests

These changes look good! 😎

Crawl results for Web Platform Design Principles

Crawl summary:

• Title: Web Platform Design Principles
• Authoring tool: bikeshed
• Date: 22 May 2025
• Revision ID: 636ff69ccc6db8f37a95ef136776f864e7f7e2c0
• Canonical URL: https://www.w3.org/TR/design-principles/
• Spec defines:
  • Algorithms: 1 found
  • Headings: 130 found
  • IDs: 915 found
  • Links: 143 rawlinks, 77 autolinks
  • References: 23 normative, 34 informative
  • Terms: 3 explicitly exported, 1 exported by default
• No CDDL, CSS, Events, Web IDL definitions found

3 explicitly exported terms

• live object, type dfn (xref search)
• static object, type dfn (xref search)
• monkey patch, type dfn (xref search)

[tidoust]

Having a definition for "monkey patch" could perhaps be useful for specs to explicitly signal sections that monkey patch another spec and are intended to change in the long run.

@browser-specs-bot pr