v1.6.0
MINOR release under the new §4.2 opt-in file-format relaxation carve-out: the .jsonc
data-file extension (comment-annotated JSON), plus a docs-site version banner. No existing pack is
affected, and a comment-free .jsonc file is plain JSON — but a .jsonc file that actually
contains comments is not readable by a strict-JSON-only Reader; it requires a JSONC-aware
Reader. This is why .jsonc ships under an explicit, bounded carve-out rather than the ordinary
"older Readers keep working" minor rule (see the JSONC bullet below and spec §4.2 / §8).
Added
- Docs site (no format change): a build-time version banner. The site now stamps the newest
releasedCHANGELOG.mdversion (SPEC_VERSIONenv →mkdocs.ymlextra.spec_version→
overrides/main.html) into a top announcement bar, so the displayed version is deterministic
and no longer depends on Material's client-side GitHub-release widget (which is cached in the
browser's localStorage and could lag a release). - JSONC support (§2.2,
§3,
§8):.jsoncfiles (C-style-commented JSON) are
now accepted anywhere.jsonfiles are specified. Hand-edited data files MAY use the.jsonc
extension to signal that they contain comments; Readers strip comments before parsing, and
Writers SHOULD preserve them on round-trip. Only comments are permitted — trailing commas and
other JSON5-style relaxations are not; after comment removal a.jsoncfile MUST be strict JSON.
The reference validator (tools/validate.py) parses.jsoncfiles accordingly. Shipped as a
MINOR bump under the §4.2 opt-in-relaxation carve-out: no existing pack is affected, and a
comment-free.jsoncfile is plain JSON, but a.jsoncfile that contains comments is readable
only by Readers that implement the comment-stripping step (a plain JSON parser errors on//),
so a Writer needing maximum reader compatibility SHOULD keep data files as comment-free.json.