KhronosGroup / KhronosGroup/glTF

Consistent JSON schema version for core and extensions

Open
#2,049 14 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
7.8k
Forks
1.2k
Avg merge
17h 26m
Merged PRs (30d)
5

Description

The JSON Schema version of the core specification has been updated from `draft-04` to `draft/2020-12` (via https://github.com/KhronosGroup/glTF/pull/2031 and https://github.com/KhronosGroup/glTF/pull/2034).

This raises some questions about the consistency of the specification. The core specification now uses `draft/2020-12`, whereas the extensions usually use `draft-04`. Without any guidelines or further actions, this could cause considerable fragmentation and inconsistencies.

Will the existing extension specifications be updated to also use `draft/2020-12`? (Who will do that, and how?)

Is there any guideline for the schema versions that extension specifications should use? (The section at https://github.com/KhronosGroup/glTF/tree/main/extensions#creating-extensions does not say anything).

Contributor guide

Open the contributing guide

Research direction

Start with the extension guidance at extensions/#creating-extensions and compare its stated guidance with the core specification's draft/2020-12 schema version and the extensions' draft-04 usage. Done means the project has a decided, documented schema-version policy and a clear plan for applying it to existing extensions.

Written by the indexing model from the issue text.

Assessment

Tech stack
json
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.