From a3258e4fd9e116ca56401083bbb1aa664b283c7d Mon Sep 17 00:00:00 2001 From: Johann Schopplich Date: Wed, 30 Sep 2026 21:30:05 +0200 Subject: [PATCH 1/4] =?UTF-8?q?docs:=20align=20the=20versioning=20example?= =?UTF-8?q?=20with=20the=20=C2=A713=20declaration?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- VERSIONING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/VERSIONING.md b/VERSIONING.md index c49f264..a379cf5 100644 --- a/VERSIONING.md +++ b/VERSIONING.md @@ -97,7 +97,7 @@ If we need to make a breaking change (MAJOR version bump): When in doubt, we err on the side of caution and treat potentially breaking changes as MAJOR version bumps. -Implementations should document the supported spec version (e.g. `"toon-spec": "3.2"`) and may support multiple versions concurrently: default to the latest, let users target a specific version, and document version-specific behavior. A new MINOR version keeps existing conformant implementations conformant. A new MAJOR version may require updates; previous-version implementations remain valid, and its CHANGELOG.md entry carries the migration guidance. A MINOR version that renames or retires a public concept handle (for example an option name) carries a migration note in CHANGELOG.md naming the old and new spelling. +Implementations should document the supported spec version (e.g., `toon-spec: 4.1`, as in SPEC.md §13) and may support multiple versions concurrently: default to the latest, let users target a specific version, and document version-specific behavior. A new MINOR version keeps existing conformant implementations conformant. A new MAJOR version may require updates; previous-version implementations remain valid, and its CHANGELOG.md entry carries the migration guidance. A MINOR version that renames or retires a public concept handle (for example an option name) carries a migration note in CHANGELOG.md naming the old and new spelling. ## Version History From d04cacf742f8b6120698af749a5a0979e6bcfd53 Mon Sep 17 00:00:00 2001 From: Johann Schopplich Date: Wed, 30 Sep 2026 21:30:05 +0200 Subject: [PATCH 2/4] =?UTF-8?q?chore:=20match=20the=20=C2=A79.3=20heading?= =?UTF-8?q?=20in=20the=20clarification=20template?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/ISSUE_TEMPLATE/clarification.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/clarification.yml b/.github/ISSUE_TEMPLATE/clarification.yml index 905059e..4f1147e 100644 --- a/.github/ISSUE_TEMPLATE/clarification.yml +++ b/.github/ISSUE_TEMPLATE/clarification.yml @@ -26,7 +26,7 @@ body: label: Specification Section description: Which section(s) are you asking about? placeholder: | - E.g., Section 9.3, "Arrays of Objects — Tabular Form" + E.g., Section 9.3, "Arrays of Objects – Tabular Form" Or: SPEC.md:383-408 validations: required: true From df977d23fbbf1e053149721211e3a4899b647c8d Mon Sep 17 00:00:00 2001 From: Johann Schopplich Date: Thu, 1 Oct 2026 21:08:17 +0200 Subject: [PATCH 3/4] chore: drop the stale line-range example from the clarification template --- .github/ISSUE_TEMPLATE/clarification.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/clarification.yml b/.github/ISSUE_TEMPLATE/clarification.yml index 4f1147e..d07e567 100644 --- a/.github/ISSUE_TEMPLATE/clarification.yml +++ b/.github/ISSUE_TEMPLATE/clarification.yml @@ -27,7 +27,6 @@ body: description: Which section(s) are you asking about? placeholder: | E.g., Section 9.3, "Arrays of Objects – Tabular Form" - Or: SPEC.md:383-408 validations: required: true From 1616a703549a01cf93b18d157f375cd138f01513 Mon Sep 17 00:00:00 2001 From: Johann Schopplich Date: Thu, 1 Oct 2026 21:08:17 +0200 Subject: [PATCH 4/4] docs: link the implementations list from the readme --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index ca3e1d1..21f28a2 100644 --- a/README.md +++ b/README.md @@ -75,6 +75,7 @@ The TOON specification uses MAJOR.MINOR versioning. See [VERSIONING.md](./VERSIO - **Test Fixtures:** [tests/fixtures/](./tests/fixtures/) – Reference test fixtures - **Changelog:** [CHANGELOG.md](./CHANGELOG.md) – Version history and changes - **Reference Implementation:** [github.com/toon-format/toon](https://github.com/toon-format/toon) – TypeScript/JavaScript implementation +- **Implementations:** [toonformat.dev/ecosystem/implementations](https://toonformat.dev/ecosystem/implementations) – Official and community ports - **Benchmarks:** [Reference repo benchmarks/](https://github.com/toon-format/toon/tree/main/benchmarks) – Token efficiency measurements and accuracy retrieval tests ## License