# State of the HTML Spec Archive — Coherence Report
_Assessment date: 2026-10-25. This report audits what is actually in [`specifications/`](./specifications),
judges whether each artifact is coherent and complete, and names concretely what is wrong._
## Verdict in one line
**Original assessment:** the archive was accurate and honestly labeled, but _not_ "perfect"
or fully self-contained — one file was mislabeled, several DTDs weren't standalone, and two of
the ten versions have no original source.
> **UPDATE (fixes applied — see the "Fixes applied" section at the bottom):** issues #1, #2,
> and #3 are now **resolved** — the mislabeled file was renamed, the XHTML 1.1 grammar is
> complete and validates offline, and the whole DTD bundle is self-resolving via SGML + XML
> catalogs. The remaining gaps (#4 prose, #5 the 1991 note / 2014 REC text) are **blocked**
> by the network sandbox, not by anything fixable here. The per-spec notes below are the
> original audit; the final section records what changed.
---
## Per-spec state
### 1. HTML Tags (1991) — ❌ no source
- **State:** Write-up only. No original document archived.
- **Problem:** The 1991 CERN note is not hosted in any reachable GitHub repo, and w3.org is
network-blocked from the build environment. Nothing was fabricated.
- **Coherent?** The *write-up* is coherent; the *archive entry* is incomplete by necessity.
### 2. HTML 2.0 — ✅ coherent & complete
- **File:** `specifications/rfc1866-html-2.0.txt`
- **State:** The **full verbatim RFC 1866 text**. Verified it ends cleanly on `[Page 77]` of
77 — no truncation. This is the single most complete original in the archive.
- **Problem:** None of substance. (It is fixed-width ASCII with form-feed page breaks and
running headers/footers, i.e. the raw RFC presentation, not reflowed prose — that is the
authentic artifact, not a defect.)
- **Coherent?** Yes. Gold standard.
### 3. HTML 3.2 — ⚠️ partial (grammar only)
- **File:** `specifications/dtd/html-3.2/HTML32.dtd` (45 ``, 44 ``, 35 ``)
- **State:** The normative DTD, intact. **Mostly self-contained** (only 2 external references,
for the ISO Latin-1 character entities).
- **Problem:** This is the **machine-readable grammar only** — the human-readable prose of the
Recommendation (the part that explains semantics) is **not** archived.
- **Coherent?** Internally coherent; incomplete as "the spec."
### 4. HTML 4.0 / 4.01 — ⚠️ partial, and NOT standalone
- **Files:** `specifications/dtd/html-4.0/{strict,loose,frameset}.dtd`,
`specifications/dtd/html-4.01/{strict,loose,frameset}.dtd` + `HTML{lat1,special,symbol}.ent`
- **State:** All three flavors for both versions, plus the three 4.01 entity sets. The
strict/loose DTDs are substantial (55 / 65 elements).
- **Problems:**
1. **`frameset.dtd` is a 1 KB stub, not a full grammar** (0 ``). It works by
pulling in the Transitional DTD via the SGML *public identifier*
`-//W3C//DTD HTML 4.01 Transitional//EN` — it does **not** reference a local file. So a
plain SGML parser pointed at `frameset.dtd` **cannot resolve it** without an SGML catalog
mapping that public ID to the local `loose.dtd`. (This is normal for the W3C DTD, but it
means the folder is not "drop-in parseable" as-is.)
2. **Prose not archived** — same gap as 3.2.
- **Coherent?** The files are authentic and internally consistent, but the set is **not a
self-resolving bundle**.
### 5. XHTML 1.0 — ⚠️ partial, external entity refs unresolved
- **Files:** `specifications/dtd/xhtml-1.0/xhtml1-{strict,transitional,frameset}.dtd`
- **State:** All three DTDs, full size (strict = 77 elements).
- **Problems:**
1. Each DTD declares the Latin-1 / symbol / special **entity sets via external identifiers**
(6 external refs in strict). Those `.ent` files are **not bundled under `xhtml-1.0/`**
(we only have copies under `html-4.01/`), so again this is **not self-resolving** without
a catalog.
2. **Prose not archived.**
- **Coherent?** Authentic, but depends on files not co-located.
### 6. XHTML 1.1 — ❌ grammar present but effectively unusable standalone
- **Files:** `specifications/dtd/xhtml-1.1/xhtml11.dtd` + `xhtml11-model-1.mod`
- **State:** `xhtml11.dtd` is the **driver DTD** — it has **0 `` declarations of its
own**. The entire vocabulary lives in **26 external modules** (`xhtml-struct.mod`,
`xhtml-text.mod`, `xhtml-form.mod`, `xhtml-table.mod`, `xhtml-ruby.mod`, … ).
- **Problem (the biggest gap in the DTD set):** We bundled only **2 of the ~27 files** this DTD
needs (`xhtml11.dtd` + `xhtml11-model-1.mod`). The other **~25 modules are missing**, so the
XHTML 1.1 grammar here **cannot actually be assembled or validated against**. It documents
the modular *structure* but is not a working grammar.
- **Coherent?** No — it is a dangling reference to files that aren't present.
### 7. HTML5 (2014) — ⚠️ no dedicated source
- **State:** No file specifically for the 2014 Recommendation. Covered indirectly by the W3C
5.x Bikeshed source (see item 9) and the WHATWG source (item 10).
- **Problem:** There is no snapshot of the actual 2014 REC text.
- **Coherent?** Write-up is fine; original not archived.
### 8. HTML 5.1 (2016) — ⚠️ no dedicated source
- **State:** Same as HTML5 — no 5.1-specific file; only the single evolving Bikeshed source.
- **Problem:** The README/write-ups imply "5.1 source ✅", but there is **no 5.1 snapshot** —
only the one `w3c-html5x` file, which (see item 9) isn't even 5.1 or 5.2.
### 9. HTML 5.2 (2017) — ❗ **MISLABELED FILE** (most important issue)
- **File:** `specifications/w3c-html52-single-page.bs`
- **State:** It **is** the authentic W3C HTML WG Bikeshed source — but its metadata header says:
`Title: HTML 5.3`, `Level: 5.3`, `Status: ED` (Editor's Draft), `TR: .../TR/html53/`.
- **Problem:** **The filename claims 5.2, but the content is the HTML 5.3 _Editor's Draft_**
(the never-finalized next-version working copy), **not** the published HTML 5.2 Recommendation.
So the "5.2 source" and "5.1 source" claims in the README are **inaccurate** — this one file
is a 5.3-ED and does not faithfully represent 5.0, 5.1, or 5.2 as published.
- **Coherent?** The file is genuine, but it is **misfiled and mis-described.** Needs renaming to
something like `w3c-html53-ED-single-page.bs` and the README corrected.
### 10. HTML Living Standard — ✅ coherent & complete
- **File:** `specifications/whatwg-html-living-standard.source.html` (8.0 MB, 164,839 lines)
- **State:** The complete `source` file. Verified it ends cleanly with `