Proposal to define profiles as conformance points

Fixes #365 Signed-off-by: Gary O'Neall <gary@sourceauditor.com>
spdx · Aug 12, 2023 · 19ab51a · 19ab51a
1 parent 4f0b0a8
commit 19ab51a
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 4 deletions.
diff --git a/model/Core/Properties/profile.md b/model/Core/Properties/profile.md
@@ -4,11 +4,13 @@ SPDX-License-Identifier: Community-Spec-1.0
 
 ## Summary
 
-Provides information about which profiles the Element belongs to.
+Describes one or more profiles which the creator of this Element intends to conform to.
 
 ## Description
 
-This field provides information about which profiles the Element belongs to.
+Describes one or more profiles to which the creator of this Element intends to conform.
+If the element represents a collection of elements, then the profile will apply to all Elements contained within the collection in addition to any profiles for the included element itself.
+Conformance to a profile is defined by the additional restrictions documented in the profile specific documentation and schema files.
 
 ## Metadata
 

diff --git a/model/Core/Vocabularies/ProfileIdentifierType.md b/model/Core/Vocabularies/ProfileIdentifierType.md
@@ -4,11 +4,15 @@ SPDX-License-Identifier: Community-Spec-1.0
 
 ## Summary
 
-Enumeration of the valid profiles that an element can be specified to be part of. 
+Enumeration of the valid profiles. 
 
 ## Description
 
-There are a set of profiles that have been defined to be valid for a specific release   This file enumerates the values that have been agreed on, and may be applied to the creation information for an an element.
+There are a set of profiles that have been defined by a profile team.
+A profile consists of a namespace that may add properties and classes to the core profile unique to the domain covered by the profile.
+The profile may also contain additional restrictions on existing properties and classes defined in other profiles.
+If a creator of an SPDX element includes a profile in the list of CreationInfo profiles, they are claiming that the element conforms to all restrictions defined for that profile.
+If the creator of an SPDX collection of elements includes a profile in the list of CreationInfo profiles, they are claiming that all contained elements conform to all restrictions defined for that profile.
 
 ## Metadata