[Tracker] Chapters for OMG/ISO

[bact]

• Cover pages
  • one for LF
  • one for OMG
• Copyrights and licensing page -- Add Copyrights and licensing page #1010
  • "The" in "The Linux Foundation" should be first-letter-capitalized #1036
• Table of contents
• Preface (add for OMG version of spec) -- Add OMG Preface page #1011
• Forward (add once ISO JTC-1 approves and we are sending final spec to ISO) -- Add ISO Foreword #1001
• Introduction -- Update Introduction chapter #1007
• 1 Scope -- Update Scope chapter #1005
• 2 References -- Update References chapter #1006
  • These PRs made changes to link labels/link URLs, or made changes to names. Just a reminder to keep links in the References chapter and links in the model file in sync.
    • Update cpe23 link in ExternalIdentifierType spdx-3-model#806
    • [Build] Specify v0.2 version number for SLSA Provenance spdx-3-model#808
    • [Core] Add text labels to bare URLs spdx-3-model#810
    • [Licensing] Add text labels to bare URLs spdx-3-model#811
    • [Security] Add text labels to bare URLs spdx-3-model#812
    • [Software] Update ref links/text labels spdx-3-model#813
    • Fix typos: hasPrerequsite -> hasPrerequisite, and others spdx-3-model#817
    • licenseXml: Link license-list-XML to a specific version (v3.24.0) spdx-3-model#819
    • Recommend to use licenseXml, instead of Legacy Text Template properties spdx-3-model#820
    • Fix casing: "package URL" -> "Package URL" at the beginning of sentence spdx-3-model#828
    • Add Adler32 to hash algorithms spdx-3-model#826
    • Add ISO number for SWHID spdx-3-model#816
• 3 Terms and definitions -- Update Terms and Definitions chapter #1004
  • Now in https://github.com/spdx/spdx-spec/blob/development/v3.0.1/docs/terms-and-definitions.md
• 4 Symbols -- Add Symbols chapter #1003
• 5 Conformance -- Update Conformance chapter #1002
  • Suggested naming convention for SPDX v3 files #987 -- Now in 3.1
• 6 Models and Serializations
  • Document the JSON-LD context #998
  • Fix bullet list in Serialization chapter (rework) #1032
  • Update info about serialization and NamespaceMap:
    • Add serialization info + NamespaceMap info #1016
    • NamespaceMap: fix TODO; "ElementID" -> "Element ID" spdx-3-model#821
  • JSON-LD Serialization doc: Fix relationship type name, Add validation info spdx-3-model#802
• 7 Core Profile
• 8 Software Profile
• 9 Security Profile
• 10 Licensing Profile
• 11 Dataset Profile
• 12 AI Profile
• 13 Build Profile
• 14 Lite Profile
  • Update Lite profile spdx-3-model#843
• 15 Extension Profile
• Annex A: Diffs from Previous Editions
  • Annex A (diffs from previous) should be about the previous ISO version #999
  • Fix copy/paste error in diffs-from-previous-editions #1035
  • Relationship type translation table is not complete yet
    • Additional migration documentation for relationship types #1019
• Annex B: RDF Object Model and Identifier Syntax
  • Annex B: Change model URL to new one at spdx.org + update to 3.0.1 URL #936
  • Check if diagrams in "RDF model" chapter up-to-dated for v3.0.1 #1058
• Annex C: SPDX License Expressions
• Annex D: SPDX license list matching guidelines
  • Where is the "Legacy Text Template format section"? spdx-3-model#747
  • Add Legacy Text Template format section back to the Matching Guidelines #1026
• Annex E: Package URL specification
• Annex F: History, Motivation and Rational -- Add OMG History chapter #1053
• Annex G: Community Specification License 1.0
• Annex H: Creative Commons Attribution License 3.0 Unported
• Annex I: SPDX Lite

---

Notes

• Heading consistency: Some chapter/annex headings capitalize the first word and lowercase the rest, while the other capitalize (almost) every words. Should stick to one style. (Exceptions can be made for proper nouns/names)
  • "SPDX license list matching guidelines" vs "History, Motivation and Rational"
  • See comments here: Correct Annex list #992 (comment)
• A question about ref consistency -- What is a standard URL to reference IETF RFC? #1012
  • Check RDF and schema URLs for v3.0.1 spec and model #1060
• Do we need to also have a subsection on Stylistic/Typographical Conventions ? -- Notes on Stylistic/Typographical Conventions #1000
• Generated files
  • Document the generated SHACL spdx-3-model#788
  • Copy the generated ontology #979
• Model
  • Change URIs to 3.0.1 spdx-3-model#800
  • Core/Element -- Need to document that Elements need to have NodeKind IRI and all other objects are blank spdx-3-model#805 -- Now in 3.1
  • Core/specVersion -- Document PATCH for specVersion spdx-3-model#733
  • Core/spdxId -- Improve the SPDX ID property documentation using#7 -- Now in using
  • Revert PR 845 - allow empty Bom and SpdxDocument element lists spdx-3-model#853
• Typos
  • Fix typos: hasPrerequsite -> hasPrerequisite, and others spdx-3-model#817
  • Add 1 missing closing ` for NamespaceMap in serialization/README spdx-3-model#824
• Pending TODOs
  • Several TODOs in specification version 3.0.0 #944

[bact]

@goneall @zvr From the TOC above, the pending changes to the model are in the remaining

• 4 open PRs (+ 1 open issue) in "2. References"
• 1 open PR in "6. Models and serializations"
• 3 open PRs in Notes/Model

Thank you.