Correct the built-in UI size in the README; tidy stale doc comments

The README still described the built-in docs page as ~1.6 KB — its size
back at v0.1.0. It has grown to ~10 KB since (security headers, the
dismissable notice, method badges, expandable operations), so the figure
was off by several times and disagreed with rawui.go. Corrected both
README spots and aligned the source comment. Also reworded a couple of
doc comments that still referenced the old "Tier" terminology the
package overview no longer uses. Logged under Unreleased — docs only, no
code change.

Author: FumingPower3925

CHANGELOG.md

@@ -7,7 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
-Nothing yet.
+### Fixed
+
+- The README described the built-in docs page as ~1.6 KB — accurate at
+  v0.1.0, but it has grown to ~10 KB across the v0.6.x additions (the
+  security headers, the dismissable notice, method badges, and the
+  expandable operations). Corrected the figure and aligned it with the
+  source. Also tidied a couple of stale doc comments left over from
+  older "Tier" terminology.
 
 ## [0.6.7] - 2026-06-14
 

README.md

@@ -36,7 +36,7 @@ The same generated document, rendered by each of the four bundled rich UIs — e
 
 ## Features
 
-- **Five UIs** — four rich consoles (Scalar, Swagger UI, Redoc, Stoplight Elements), each CDN-pinned with SRI integrity hashes or fully embedded for air-gapped builds, plus a tiny dependency-free default (~1.6 KB).
+- **Five UIs** — four rich consoles (Scalar, Swagger UI, Redoc, Stoplight Elements), each CDN-pinned with SRI integrity hashes or fully embedded for air-gapped builds, plus a tiny dependency-free default (~10 KB).
 - **Three OpenAPI versions** — 3.0.4 (default), 3.1.2, and 3.2.0, all externally validated.
 - **Reflection** — Go types become JSON Schemas following the `encoding/json` contract, with documentation and validation rules (`minimum`, `maxLength`, `pattern`, `enum`, `default`, …) read from struct tags.
 - **Typed parameters** — declare query/header/cookie parameters from a struct or inline with typed, validated modifiers.
@@ -108,7 +108,7 @@ mux := stdocs.New(stdocs.WithTitle("My API"), scalar.WithUI())
 
 | UI                              | CDN sub-package                       | Embedded sub-package                       |
 | ------------------------------- | ------------------------------------- | ------------------------------------------ |
-| _(default)_ (built-in, ~1.6 KB) | —                                     | —                                          |
+| _(default)_ (built-in, ~10 KB)  | —                                     | —                                          |
 | Scalar                          | `ui/scalar` (~3.6 MB from the CDN)    | `ui/scalaremb` (~3.6 MB in your binary)    |
 | Swagger UI                      | `ui/swaggerui` (~1.7 MB from the CDN) | `ui/swaggeruiemb` (~1.7 MB in your binary) |
 | Redoc                           | `ui/redoc` (~1.1 MB from the CDN)     | `ui/redocemb` (~1.1 MB in your binary)     |

cmd/demo/main.go

@@ -1,7 +1,8 @@
 // Package main is a demo of stdocs using a fictional Task Tracker API.
 //
-// Everything here uses the *stdocs.Mux path (what doc.go calls
-// Tier 2). It shows both levels of route documentation:
+// Everything here uses the *stdocs.Mux path — the one that builds the
+// document from your live routes (see "Two ways to use it" in the
+// package docs). It shows both levels of route documentation:
 //
 //   - zero-config: a route registered with no documentation opts gets
 //     a summary inferred from the function name and a tag from the
@@ -207,7 +208,7 @@ func main() {
 		scalar.WithUI(),
 	)
 
-	// Tier 2 examples: rich metadata. Each call uses per-route opts
+	// Documented examples: rich metadata. Each call uses per-route opts
 	// to document the response body and request body types.
 	mux.HandleFunc("GET /tasks", listTasks,
 		stdocs.Summary("List all tasks"),

doc.go

@@ -6,9 +6,9 @@
 //
 // The pattern syntax it documents ("GET /users/{id}") is the
 // method+path routing introduced in Go 1.22; the module itself
-// requires Go 1.24 or later. There are no dependencies beyond the standard library and
-// no code generation: the patterns you already write are the source
-// of truth.
+// requires Go 1.24 or later. There are no dependencies beyond
+// the standard library and no code generation: the patterns you
+// already write are the source of truth.
 //
 // # Two ways to use it
 //

rawui.go

@@ -1,7 +1,7 @@
 package stdocs
 
 // defaultUIDoc is the default docs page HTML, served at the docs prefix
-// when no UI sub-package is imported. It is a small (~6 KB)
+// when no UI sub-package is imported. It is a small (~10 KB)
 // dependency-free page — no CDN, no external assets — whose inline
 // script fetches the JSON spec and renders the operations grouped by
 // path, with method badges, an auth padlock on secured operations, and