CSAF $id property - Githubissues

oasis-tcs / csaf

OASIS CSAF TC: Supporting version control for Work Product artifacts developed by members of TC, including prose specifications and secondary artifacts like meeting minutes and productivity code

https://github.com/oasis-tcs/csaf

Other

147 stars 39 forks source link

CSAF $id property #64

Closed tschmidtb51 closed 4 years ago

tschmidtb51 commented 4 years ago

The schema should have an $id property. "The $id property is a URI-reference that serves two purposes:

It declares a unique identifier for the schema.
It declares a base URI against which $ref URI-references are resolved.

It is best practice that every top-level schema should set $id to an absolute-URI (not a relative reference), with a domain that you control." https://json-schema.org/understanding-json-schema/structuring.html#the-id-property

tschmidtb51 commented 4 years ago

I would suggest this links to the Github version of the schema for now. Later on, once it gets official, we should use of the official https://docs.oasis-open.org/csaf/ns/ namespace.