Skip to content

Add the improve-existing principle - #628

Open
csarven wants to merge 3 commits into
w3ctag:mainfrom
csarven:csarven-improve-existing-principle
Open

csarven wants to merge 3 commits into
w3ctag:mainfrom
csarven:csarven-improve-existing-principle

Conversation

@csarven

@csarven csarven commented Sep 17, 2026 •

Copy link
Copy Markdown
Member

Closes #539.

This PR adds the principle "Improve existing technologies rather than inventing new ones". It is a positive take on the framing in the issue. That is, what to do, rather than only what to avoid.

I placed it after #new-features, which already advises considering integration with existing, similar capabilities. There is also a cross-reference from #text-formats, where the discussion behind #539 started.

This principle generalises principles currently in the document, such as #extend-manifests, #attribute-reuse, #prefer-existing-task-sources, and #dont-invent-event-like. Maybe there are others that I've overlooked, but good enough for now.

I used these common examples to illustrate unique ideas mentioned up front:

  • JSON, the remedy short of replacement
  • Microdata/RDFa/JSON-LD, the test for what counts as reinvention
  • URL Standard, what displacement requires
  • URL Pattern and URL Fragment Text Directives, prior work not built on, whether in another standards org or the same one
  • XHTML 2.0, the failure mode and the recovery
  • fetch(), the passable test

Preview | Diff

Comment thread index.bs Resolved
Comment thread index.bs Resolved

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New principle: Don't invent something new just because the existing thing isn't perfect

2 participants