Awesome! Thanks for the context and clarification Gary! On Thu, Jan 5, 2023 at 8:09 AM Gary O'Neall <[email protected]> wrote:
> Hi Brandon, > > > > I believe it is safe to ignore the v2.2.0 JSON schema. > > > > The “describesPackages” was deprecated on release 2.0 of the spec and is > only used for compatibility with pre 2.0 spec version using the RDF > format. There is an open issue to remove this property > <https://github.com/spdx/spdx-spec/issues/534>. It was probably in the > 2.2.0 JSON schema due to it being generated from the RDF schema which still > has the deprecated property. It looks like PR #528 > <https://github.com/spdx/spdx-spec/pull/528/files> is where the property > was replaced with the more appropriate “documentDescribes”. > > > > In the past, we’ve used the JSON examples as the primary documentation for > the JSON format. With the fixes from PR 528, we should be able to use both > the JSON Schema and the examples. The documentation for the JSON format > should be dramatically improved in the 3.0 spec. > > > > Cheers, > Gary > > > > > > *From:* [email protected] <[email protected]> *On Behalf Of > *Brandon Lum via lists.spdx.org > *Sent:* Wednesday, January 4, 2023 1:13 AM > *To:* SPDX Technical Mailing List <[email protected]> > *Subject:* [spdx-tech] clarification around "documentDescribes" field > > > > Hi! > > > > An issue <https://github.com/spdx/tools-golang/issues/166> was opened in > tools-golang around the missing "documentDescribes" field, which is part of > the JSON schema. > > > > For v2.2.1 and above, the field is present, however, in v2.2.0 of the spec > <https://github.com/spdx/spdx-spec/blob/v2.2/schemas/spdx-schema.json>, > it looks like the field is called "describesPackages", however, in the same > tag, the v2.2.0 example > <https://github.com/spdx/spdx-spec/blob/v2.2/examples/SPDXJSONExample-v2.2.spdx.json#L58> > uses "documentDescribes". > > > > Based on some of the wording from Gary's Java library around 2020, and > looking through the v2.2.0 docs, i'm guessing that the JSON spec was still > not fully approved then... So it should be safe to ignore the v2.2.0 JSON > schema spec? > > > > Cheers > > Brandon > > > -=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#4908): https://lists.spdx.org/g/Spdx-tech/message/4908 Mute This Topic: https://lists.spdx.org/mt/96047024/21656 Group Owner: [email protected] Unsubscribe: https://lists.spdx.org/g/Spdx-tech/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
