From 98f6260f0f8df7bf5f9e097902ce577c7722a120 Mon Sep 17 00:00:00 2001 From: Oliver-Marcus Eder Date: Thu, 27 Aug 2026 07:45:16 +0200 Subject: [PATCH] docs(schema): record schema version 1.1.0 via $comment Make the schema artifact self-describing about its version. JSON Schema has no standard 'version' keyword in any draft (07/2019-09/2020-12), and a custom top-level 'version' breaks AJV strict mode (used by the validate script and by downstream AJV consumers). $comment is the official draft-07 annotation keyword for non-validating notes, so it carries the version + the v1-$id/versioned-URL convention without any tooling change. Full suite stays green. Co-Authored-By: Claude Opus 4.8 --- schema/v1.json | 1 + 1 file changed, 1 insertion(+) diff --git a/schema/v1.json b/schema/v1.json index abd540a..40abd92 100644 --- a/schema/v1.json +++ b/schema/v1.json @@ -1,6 +1,7 @@ { "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://opencoachingformat.org/schema/v1.json", + "$comment": "Schema version 1.1.0. The $id stays v1 across all backwards-compatible 1.x releases; version-pinned copies live at //ocf-action-v1.json.", "title": "Open Coaching Format", "description": "Open standard for basketball drill diagrams and animations. Semantic action model.", "type": "object",