Skip to content

Restate the schema bundle figures for 18 versions - #36

Merged
samuelduchesne merged 1 commit into
mainfrom
schema-figures-18-versions
Oct 19, 2026
Merged

samuelduchesne merged 1 commit into
mainfrom
schema-figures-18-versions

Conversation

@samuelduchesne

Copy link
Copy Markdown
Contributor

Summary

The content-addressed schemas page said "18 versions" beside figures from an older 17-version bundle. Its distinct-definition count and its sizes also predated the slim-format change in idfkit-js#37. This change re-measures the figures and restates them on four pages.

Figures

The bundle figures were measured from the committed bundle in idfkit-js main (df211d6, "Adopt EnergyPlus 26.2.0"). The raw figure was measured from src/idfkit/schemas in idfkit main.

Figure Before After How measured
Versions 17 / 18 (mixed) 18 index.json versions
Type entries 14,092 14,972 Sum of manifest sizes
Distinct definitions 2,568 2,788 Entries in types.json
Repeated share 82% 81% 1 - 2,788 / 14,972
Raw schemas, gzipped 11,915 KB 12,277 KB Sum of the 18 Energy+.schema.epJSON.gz
Slimmed, gzipped 2,922 KB 3,028 KB Each version's slim definitions as one JSON document, gzip level 9, without the prose pool
Content-addressed, gzipped about 1,000 KB 1,189 KB index, 18 manifests and types; the prose pool (173 KB) is stated separately

As a check, the same method applied to the bundle before 26.2.0 gives 14,092 entries, which matches the page. The method gives 2,735 distinct definitions rather than 2,568, and that difference is what dates the older figure.

Pages

  1. explanation/content-addressed-schemas.md: the introduction, the deduplication paragraph and the table, plus one sentence on what the content-addressed figure covers.
  2. reference/typescript/schemas.md, how-to/parse-in-the-browser.md and reference/slim-schema-format.md: "around 1 MB" becomes "about 1.2 MB", and 11.9 MB becomes 12.3 MB.

Not changed here

  1. explanation/naming-map.md still says "all seventeen schemas". That sentence is generated from governance/naming.toml in idfkit-conformance, so the fix belongs there and reaches this page with the next governance tag.
  2. docs/typedoc/typedoc.json is generated from idfkit-js. It still says "~1 MB gzipped against ~6 MB raw".

Verification

make docs-test was run locally against the workspace's conformance checkout. It reported no warning on the changed pages. It still failed strict mode on 113 social-card warnings, because cairosvg cannot load libcairo on this machine, and on one local-override warning.

The explanation page said 18 versions beside figures from an older
17-version bundle. The figures are re-measured from the committed bundle
in idfkit-js (df211d6) and the raw schemas in idfkit main.
github-actions Bot added a commit that referenced this pull request Oct 19, 2026
@samuelduchesne
samuelduchesne merged commit 51fea89 into main Oct 19, 2026
7 checks passed
github-actions Bot added a commit that referenced this pull request Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant