diff --git a/peps/pep-0739.rst b/peps/pep-0739.rst index 886a03d31..9656f38ba 100644 --- a/peps/pep-0739.rst +++ b/peps/pep-0739.rst @@ -74,7 +74,7 @@ below, which is rendered in an human-readable format here. * - ``$schema`` - https://json-schema.org/draft/2020-12/schema * - ``$id`` - - https://github.com/python/peps/blob/main/peps/pep-0739/python-build-info-v1.schema.json + - https://github.com/python/peps/blob/main/peps/pep-0739/python-build-info-v1.0.schema.json * - Title - Static description file for the build details of Python installations @@ -90,13 +90,28 @@ below, which is rendered in an human-readable format here. :widths: 25 75 * - Type - - ``string`` (constant — ``1``) + - ``string`` (constant — ``1.0``) * - Description - Schema version. - This is a constant value and MUST be ``1``, when using the - schema described here. Future iterations of this schema MUST - update this value. + This is a string following the format ``.``, where + ```` and ```` are unpaded numbers and represent + the **major** and **minor** components of the version. Versions + may be arithmetic compared by intrepreting the version string as + a decimal number. + + For this specification version, this value is constant and MUST + be ``1.0``. + + Future versions of this schema MUST use a higher version number. + Future versions of this schema MUST NOT use the same **major** + version component as other schema version unless its + specification is deemed backwards-compatible with them — it + can't change, or extend, any parts of the current specification + in such a way as the semantics of the interpreted data differ, + or that data valid under the new specification is invalid under + the older specification, with the exception of additional + properties (errors caused by ``additionalProperties``). * - Required - **True** @@ -698,7 +713,7 @@ Example JSON Schema =========== -.. literalinclude:: pep-0739/python-build-info-v1.schema.json +.. literalinclude:: pep-0739/python-build-info-v1.0.schema.json :language: json :linenos: diff --git a/peps/pep-0739/example.json b/peps/pep-0739/example.json index ab9dbc402..f2147bc95 100644 --- a/peps/pep-0739/example.json +++ b/peps/pep-0739/example.json @@ -1,5 +1,5 @@ { - "schema_version": "1", + "schema_version": "1.0", "base_prefix": "/usr", "platform": "linux-x86_64", "language": { diff --git a/peps/pep-0739/python-build-info-v1.schema.json b/peps/pep-0739/python-build-info-v1.0.schema.json similarity index 91% rename from peps/pep-0739/python-build-info-v1.schema.json rename to peps/pep-0739/python-build-info-v1.0.schema.json index 49240b751..3e0cfd263 100644 --- a/peps/pep-0739/python-build-info-v1.schema.json +++ b/peps/pep-0739/python-build-info-v1.0.schema.json @@ -1,6 +1,6 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", - "$id": "https://github.com/python/peps/blob/main/peps/pep-0739/python-build-info-v1.schema.json", + "$id": "https://github.com/python/peps/blob/main/peps/pep-0739/python-build-info-v1.0.schema.json", "type": "object", "title": "Static description file for the build details of Python installations", "required": [ @@ -13,8 +13,8 @@ "properties": { "schema_version": { "type": "string", - "description": "Schema version.\n\nThis is a constant value and MUST be ``1``, when using the schema described here. Future iterations of this schema MUST update this value.", - "const": "1" + "description": "Schema version.\n\nThis is a string following the format ``.``, where ```` and ```` are unpaded numbers and represent the **major** and **minor** components of the version. Versions may be arithmetic compared by intrepreting the version string as a decimal number.\n\nFor this specification version, this value is constant and MUST be ``1.0``.\n\nFuture versions of this schema MUST use a higher version number. Future versions of this schema MUST NOT use the same **major** version component as other schema version unless its specification is deemed backwards-compatible with them — it can't change, or extend, any parts of the current specification in such a way as the semantics of the interpreted data differ, or that data valid under the new specification is invalid under the older specification, with the exception of additional properties (errors caused by ``additionalProperties``).", + "const": "1.0" }, "base_prefix": { "type": "string",