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
146 stars 39 forks source link

Clarify terminology of initial release of document version in 3.1.11.1 Version Type - Integer versioning #791

Open sonnyvanlingen opened 1 day ago

sonnyvanlingen commented 1 day ago

Section 3.1.11.1 Version Type - Integer versioning documents that:

Version 1 defines the initial public release. Each new version where /document/tracking/status is final has a version number incremented by one.

This may be misleading as it implies a release to the general public, while it could also refer to controlled disclosure labeled TLP:GREEN or higher.

My suggestion is to simply remove the word public altogether changing the text to:

Version 1 defines the initial release. Each new version where /document/tracking/status is final has a version number incremented by one.

tschmidtb51 commented 1 day ago

We need to check that this aligns through out the standard.