docs

Signed-off-by: Jan Kowalleck <[email protected]>

Author: jkowalleck

schema/bom-1.7.proto

@@ -421,9 +421,8 @@ message License {
 // It must be a valid SPDX license expression, along with additional properties such as license acknowledgment.
 message LicenseExpressionDetailed {
 
-  // Specifies the details and attributes related to a software license identifier.
-  // (An SPDX expression may be a compound of license identifiers.)
-  // The field `license_identifier` serves as the key which identifies each record. The key is not meant to be unique, as one and the same license identifier could apply to multiple, different but similar license details, texts, etc.
+  // This document specifies the details and attributes related to a software license identifier. An SPDX expression may be a compound of license identifiers.
+  // The `license_identifier` field serves as the key that identifies each record. Note that this key is not required to be unique, as the same license identifier could apply to multiple, different but similar license details, texts, etc.
   message ExpressionDetails {
     // A valid SPDX license identifier. Refer to https://spdx.org/specifications for syntax requirements.
     // This field serves as the primary key, which uniquely identifies each record.

schema/bom-1.7.schema.json

@@ -1500,7 +1500,7 @@
                 "type": "array",
                 "items": {
                   "type": "object",
-                  "description": "Specifies the details and attributes related to a software license identifier.\n(An SPDX expression may be a compound of license identifiers.)\nThe property `licenseIdentifier` serves as the key which identifies each record. The key is not meant to be unique, as one and the same license identifier could apply to multiple, different but similar license details, texts, etc.",
+                  "description": "This document specifies the details and attributes related to a software license identifier. An SPDX expression may be a compound of license identifiers.\nThe `license_identifier` property serves as the key that identifies each record. Note that this key is not required to be unique, as the same license identifier could apply to multiple, different but similar license details, texts, etc.",
                   "required": [
                     "licenseIdentifier"
                   ],

schema/bom-1.7.xsd

@@ -998,9 +998,8 @@ limitations under the License.
                 <xs:complexType>
                     <xs:annotation>
                         <xs:documentation>
-                            Specifies the details and attributes related to a software license identifier.
-                            (An SPDX expression may be a compound of license identifiers.)
-                            The attribute `license-identifier` serves as the key which identifies each record. The key is not meant to be unique, as one and the same license identifier could apply to multiple, different but similar license details, texts, etc.
+                            This document specifies the details and attributes related to a software license identifier. An SPDX expression may be a compound of license identifiers.
+                            The `license-identifier` attribute serves as the key that identifies each record. Note that this key is not required to be unique, as the same license identifier could apply to multiple, different but similar license details, texts, etc.
                         </xs:documentation>
                     </xs:annotation>
                     <xs:sequence>