spdx-spec
spdx-spec copied to clipboard
SPDX documentation not in sync with schema
documentNamespace is a required field in v2.3.0 as per documentation but has not been mentioned in the required array in schema
It looks like it is included in the required array here:
https://github.com/spdx/spdx-spec/blob/8a595028b0386138c84f7188237787c374f6a6cf/schemas/spdx-schema.json#L748
Yes, it is mentioned as a required field in development/v2.3.1 but not in development/v2.3 which created confusion. Do you suggest we follow the 2.3.1 branch?
Yes, it is mentioned as a required field in development/v2.3.1 but not in development/v2.3 which created confusion.
Good point. This must have been an issue identified in 2.3.0 and fixed in the development branch.
Do you suggest we follow the 2.3.1 branch?
2.3.1 is not yet released, so there is some risk of picking up a change that may be amended later. That being said, we are only fixing critical issues in 2.3 at the moment, so you could follow the 2.3.1 branch if you want the most up to date fixes.
If the tech workgroup had more bandwidth, we'd probably do a patch release of 2.3.1, but we're all working hard to get the 3.0 release out.