docs: phase 8 â Overview / URLPattern-101 section#9
Merged
Conversation
Two pages explaining URLPattern itself for a Python developer who's
never seen the standard before — the conceptual onramp the project
needed alongside the worked examples.
* docs/overview/what-is-urlpattern.md — five anchored concepts:
1. path-to-regexp lineage (the "paved cowpath" rationale)
2. service-worker scoping as the originating problem
3. dual-purpose API (developer-facing + platform primitive)
4. component-wise matching over whole-URL regex
5. canonicalize-then-match semantics
Footnotes cite WHATWG spec, WICG explainer, W3C TAG #417, WebKit
and Mozilla standards positions, Chrome for Developers, web.dev
Baseline. Ends with a ranked top-3 "if you want to learn URLPattern,
read these" intro list.
* docs/overview/ecosystem-adoption.md — chronological timeline from
WICG incubation (2019) to Baseline Newly Available (Sep 2025), with
snapshot tables for browser engines, server runtimes, and framework
adoption. Built as the citation surface for "is this a stable bet?"
properdocs nav grows an Overview section as the first entry after Home.
github-actions
Bot
added
the
documentation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Two pages explaining URLPattern itself for a Python audience that has never seen the standard before.
docs/overview/what-is-urlpattern.md— five anchored concepts:Every claim is footnoted to a primary source: the WHATWG spec, the WICG explainer, the W3C TAG #417 design review, WebKit / Mozilla standards positions, Chrome for Developers, web.dev Baseline. Ends with a ranked top-3 list for readers who want to learn URLPattern conceptually before touching Python.
docs/overview/ecosystem-adoption.md— citation surface for "is this a stable bet?" Chronological timeline from WICG incubation in 2019 to Baseline Newly Available in September 2025, plus snapshot tables for browser engines (Blink / Gecko / WebKit), server runtimes (Deno / Workers / Bun / Node.js), and framework adoption (Hono PatternRouter, Deno @std/http/route, Next.js Edge, Netlify).properdocs nav grows an Overview section as the first entry after Home.
Test plan
just docsstrict build cleanjust lintall 11 tools pass