From 19ab51a4e18ed7eae4bfa4207abbd682f171d0f2 Mon Sep 17 00:00:00 2001 From: Gary O'Neall Date: Sat, 29 Jul 2023 10:54:28 -0700 Subject: [PATCH] Proposal to define profiles as conformance points Fixes #365 Signed-off-by: Gary O'Neall --- model/Core/Properties/profile.md | 6 ++++-- model/Core/Vocabularies/ProfileIdentifierType.md | 8 ++++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/model/Core/Properties/profile.md b/model/Core/Properties/profile.md index 3aa4f2c63..6f62347f0 100644 --- 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 index fe8b400aa..6272f3434 100644 --- 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