feat: replace characterizationFactorsSources by ippcCharacterizationF…

…actorsSources

decisions/log/0028-provide-clarity-on-characterization-factors.md

@@ -37,7 +37,7 @@ preference for having the possibility of including more than one characterizatio
 
     (Please refer to the proposed changes to the technical specification for a more detailed and complete diff.)
 
-2. Add the new mandatory property `characterizationFactorsSources` with the new data type `CharacterizationFactorsSources`, defined as a non-empty `Array` of `CharacterizationFactorsSource`. The new data type `CharacterizationFactorsSource` is defined as an `Object` with the mandatory fields `"name"` and `"version"`, both of which are non-empty `Strings`. The value of the `"name"` field SHOULD be `"IPCC Assessment Report"` and the version SHOULD be either `"5"` or `"6"`.
+2. Add the new mandatory property `ipccCharacterizationFactorsSources` defined as a non-empty `Array` of `Strings` with the format `AR$VERSION$`, where `$VERSION$` stands for the IPCC report version number and MUST be an integer.
 
 ### Rationale
 
@@ -51,4 +51,4 @@ It is forward-looking because future adaptations are unlikely to break backwards
 
 1. This ADR introduces a minor change: since the `characterizationFactors` property is maintained, it is backwards compatible.
 2. Accordingly, the Technical Specifications version number must be updated from 2.1.x to 2.2.0.
-3. Host systems need to validate the new property `characterizationFactorsSources` depending on the value of ProductFootprint's property `specsVersion`
+3. Host systems need to validate the new property `ipccCharacterizationFactorsSources` depending on the value of ProductFootprint's property `specsVersion`

spec/v2/index.bs

@@ -502,13 +502,19 @@ Advisement:
           :: for the Sixth Assessment Report of the Intergovernmental Panel on Climate Change (IPCC)
           : `AR5`
           :: for the Fifth Assessment Report of the IPCC.
-      <tr>
-        <td><dfn>characterizationFactorsSources</dfn>  : <{CharacterizationFactorsSource}>[]
-        <td>Array
+     <tr>
+        <td><dfn>ipccCharacterizationFactorsSources</dfn>
+        <td>Array of Strings
         <td>M
-        <td>The characterization factors from one or more IPCC Assessment Reports used in the calculation of the PCF (see [=Pathfinder Framework=] Section 3.2.2). The value MUST be a non-empty set of <{CharacterizationFactorsSource}>.
+        <td>The characterization factors from one or more IPCC Assessment Reports used in the calculation of the PCF (see [=Pathfinder Framework=] Section 3.2.2).
+              It MUST be a non-empty set of strings with the format `AR$VERSION$`, where `$VERSION$` stands for the
+              IPCC report version number and MUST be an integer.
 
-          Advisement: Per the Framework, the latest available characterization factor version shall be used. In the event this is not possible, include the set of all characterization factors used.
+          Example values:
+          <div class=example>["AR6"]</div>
+          <div class=example>["AR5", "AR6"]</div>
+
+          Advisement: Per the Framework, the latest available characterization factor version shall be used, i.e., `["AR6"]`. In the event this is not possible, include the set of all characterization factors used.
       <tr>
         <td><dfn>crossSectoralStandardsUsed</dfn> : [=CrossSectoralStandardSet=]
         <td>Array
@@ -1390,41 +1396,6 @@ Example JSON string value:
 ```
 </div>
 
-## Data Type: <dfn element>CharacterizationFactorsSource</dfn> ## {#dt-characterizationfactorssource}
-
-A `CharacterizationFactorsSource` references a source of the characterization factors used in the calculation of the <{CarbonFootprint}> (see [=Pathfinder Framework=] Section 3.2.2).
-
-### Properties ### {#dt-characterizationfactorssource-properties}
-
-<dl dfn-type="element-attr" dfn-for="CharacterizationFactorsSource">
-: <dfn>name</dfn> (mandatory, data type: [=NonEmptyString=])
-:: The non-empty name of the
-    characterization factors source. Presently, the value SHOULD be `"IPCC Assessment Report"`,
-    referring to the characterization factors (100-year GWP, including carbon feedbacks) derived from
-    the IPCC Assessment Report publication.
-
-: <dfn>version</dfn> (mandatory, data type: [=NonEmptyString=])
-:: The non-empty version of the
-    characterization factors source. Presently, the value SHOULD be either `"5"` or `"6"`, referring to
-    the 5th (AR5) and 6th (AR6) IPCC Assessment Reports, respectively.
-    </dl>
-
-<div class=example>
-Example encoding of a <{CharacterizationFactorsSource}> in JSON:
-
-```json
-{
-  "name": "IPCC Assessment Report",
-  "version": "6"
-}
-```
-</div>
-
-
-### JSON Representation ### {#dt-characterizationfactorssource-json}
-
-Each <{CharacterizationFactorsSource}> MUST be encoded as a JSON object.
-
 # Product Footprint Lifecycle # {#lifecycle}
 
 ## Introduction ## {#lifecycle-intro}