From daf272b7a185d3f4b4f684491f4f7a640fe1ec83 Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Mon, 26 Aug 2024 17:19:40 +0100 Subject: [PATCH 1/7] feat: initial proposal on how to improve integration chapter --- specs/index.bs | 148 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 147 insertions(+), 1 deletion(-) diff --git a/specs/index.bs b/specs/index.bs index 7c6504b..47c64f8 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -1910,7 +1910,7 @@ With response parameters The Data types defined in [[#data-model]] are specific to [[!ISO14083]] and the [[!GLEC]] Framework. This section specifies the integration of the data types <{ShipmentFootprint}>, <{TOC}>, and <{HOC}> into the PACT Data Model ([[!PACTDX]] Chapter 4). -The integration of the data types <{ShipmentFootprint}> and <{TOC}> is achieved by storing them as extensions to the PACT Data Model (see [[!DATA-MODEL-EXTENSIONS]]). +The integration of the data types <{ShipmentFootprint}>, <{TOC}>, and <{HOC}> is achieved by storing them as extensions to the PACT Data Model (see [[!DATA-MODEL-EXTENSIONS]]). Therefore, all properties defined in the latter are also properties of the former. As a result, some properties relevant to logistics do not need to be defined in the [[#data-model]]. The list below contains the properties that were omitted for this reason. @@ -2001,6 +2001,12 @@ Note: Section [[#appendix-b-sf-example]] contains an example. MUST equal the total ton kilometers over all TCEs (<{ShipmentFootprint/tces}>), calculated by taking the sum of the ton kilometers over all TCEs (see property <{TCE/transportActivity}>) + + CarbonFootprint + `productMassPerDeclaredUnit` + + MUST equal the mass of the shipment (<{ShipmentFootprint/mass}>) + CarbonFootprint `pCfExcludingBiogenic` @@ -2024,6 +2030,18 @@ Note: Section [[#appendix-b-sf-example]] contains an example. see the specification for `pCfExcludingBiogenic` in this table + + CarbonFootprint + `fossilCarbonContent` + + see the specification for `pCfExcludingBiogenic` in this table + + + CarbonFootprint + `biogenicCarbonContent` + + see the specification for `pCfIncludingBiogenic` in this table + CarbonFootprint `packagingEmissionsIncluded` @@ -2044,6 +2062,36 @@ Note: Section [[#appendix-b-sf-example]] contains an example.
Mapping of PACT Data Model properties to <{ShipmentFootprint}> properties
+The `ProductFootprint` mandatory properties +[id](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-id), +[specVersion](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-specversion), +[version](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-version), +[status](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-status), +[companyName](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-companyname), +[companyIds](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-companyids), +[productDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-productdescription), +and +[productNameCompany](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-productnamecompany) +cannot be derived from the `ShipmentFootprint` and MUST be provided by the data owner. Please follow +the links above for further details. + +The `CarbonFootprint` mandatory properties +[characterizationFactors](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-characterizationfactors), +[ipccCharacterizationFactorsSources](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-ipcccharacterizationfactorssources), +[crossSectoralStandardsUsed](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-crosssectoralstandardsused), +[crossSectoralStandars](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-crosssectoralstandards), +[boundaryProcessesDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-boundaryprocessesdescription), +[referencePeriodStart](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-referenceperiodstart), +[referencePeriodEnd](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-referenceperiodend), +[exemptedEmissionsPercent](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-exemptedemissionspercent), +and +[exemptedEmissionsDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-exemptedemissionsdescription) +cannot be derived from the `ShipmentFootprint` and MUST be provided by the data owner. Please follow +the links above for further details. + +Any optional property that is not explicitly mentioned above MAY remain unset. All mandatory +properties that cannot be derived from `ShipmentFootprint` CAN be populated in a best-effort manner. + ### TOC ### {#pcf-mapping-toc} Note: This chapter refers to the PACT Data Model. See [[!PACTDX]] Chapter 4 for further details. @@ -2097,6 +2145,13 @@ Note: Section [[#appendix-b-toc-example]] contains an example. SHOULD be set to `"1"` so that the ProductFootprint represents the emissions per ton kilometer of the TOC. + + + CarbonFootprint + `productMassPerDeclaredUnit` + + MUST be set to `"1"`. + CarbonFootprint `pCfExcludingBiogenic` @@ -2119,6 +2174,18 @@ Note: Section [[#appendix-b-toc-example]] contains an example. see the specification for `pCfExcludingBiogenic` in this table + + CarbonFootprint + `fossilCarbonContent` + + see the specification for `pCfExcludingBiogenic` in this table + + + CarbonFootprint + `biogenicCarbonContent` + + see the specification for `pCfIncludingBiogenic` in this table + CarbonFootprint `packagingEmissionsIncluded` @@ -2138,6 +2205,37 @@ Note: Section [[#appendix-b-toc-example]] contains an example.
Mapping of PACT Data Model properties to <{TOC}> properties
+ +The `ProductFootprint` mandatory properties +[id](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-id), +[specVersion](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-specversion), +[version](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-version), +[status](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-status), +[companyName](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-companyname), +[companyIds](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-companyids), +[productDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-productdescription), +and +[productNameCompany](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-productnamecompany) +cannot be derived from the `TOC` and MUST be provided by the data owner. Please follow the links +above for further details. + +The `CarbonFootprint` mandatory properties +[characterizationFactors](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-characterizationfactors), +[ipccCharacterizationFactorsSources](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-ipcccharacterizationfactorssources), +[crossSectoralStandardsUsed](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-crosssectoralstandardsused), +[crossSectoralStandars](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-crosssectoralstandards), +[boundaryProcessesDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-boundaryprocessesdescription), +[referencePeriodStart](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-referenceperiodstart), +[referencePeriodEnd](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-referenceperiodend), +[exemptedEmissionsPercent](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-exemptedemissionspercent), +and +[exemptedEmissionsDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-exemptedemissionsdescription) +cannot be derived from the `TOC` and MUST be provided by the data owner. Please follow +the links above for further details. + +Any optional property that is not explicitly mentioned above MAY remain unset. All mandatory +properties that cannot be derived from `TOC` CAN be populated in a best-effort manner. + ### HOC ### {#pcf-mapping-hoc} Note: This chapter refers to the PACT Data Model. See [[!PACTDX]] Chapter 4 for further details. @@ -2191,6 +2289,12 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. MUST be set to `"1000"` so that the ProductFootprint represents the emissions of the HOC per tonne leaving the hub. + + CarbonFootprint + `productMassPerDeclaredUnit` + + MUST be set to `"1000"`. + CarbonFootprint `pCfExcludingBiogenic` @@ -2217,6 +2321,18 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. see the specification for `pCfExcludingBiogenic` in this table + + CarbonFootprint + `fossilCarbonContent` + + see the specification for `pCfExcludingBiogenic` in this table + + + CarbonFootprint + `biogenicCarbonContent` + + see the specification for `pCfIncludingBiogenic` in this table + CarbonFootprint `packagingEmissionsIncluded` @@ -2237,6 +2353,36 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. +The `ProductFootprint` mandatory properties +[id](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-id), +[specVersion](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-specversion), +[version](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-version), +[status](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-status), +[companyName](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-companyname), +[companyIds](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-companyids), +[productDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-productdescription), +and +[productNameCompany](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-productfootprint-productnamecompany) +cannot be derived from the `HOC` and MUST be provided by the data owner. Please follow +the links above for further details. + +The `CarbonFootprint` mandatory properties +[characterizationFactors](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-characterizationfactors), +[ipccCharacterizationFactorsSources](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-ipcccharacterizationfactorssources), +[crossSectoralStandardsUsed](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-crosssectoralstandardsused), +[crossSectoralStandars](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-crosssectoralstandards), +[boundaryProcessesDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-boundaryprocessesdescription), +[referencePeriodStart](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-referenceperiodstart), +[referencePeriodEnd](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-referenceperiodend), +[exemptedEmissionsPercent](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-exemptedemissionspercent), +and +[exemptedEmissionsDescription](https://wbcsd.github.io/data-exchange-protocol/v2/#element-attrdef-carbonfootprint-exemptedemissionsdescription) +cannot be derived from the `HOC` and MUST be provided by the data owner. Please follow +the links above for further details. + +Any optional property that is not explicitly mentioned above MAY remain unset. All mandatory +properties that cannot be derived from `HOC` CAN be populated in a best-effort manner. + # Appendix A: Changelog # {#changelog} ## Version 0.2.1-20240903 (2024-09-03) ## {#version-20240903} From 73d749f12cda2f85cde7f91d9725b0fbffedcf1f Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Tue, 3 Sep 2024 12:23:25 +0100 Subject: [PATCH 2/7] feat: update pCfIncludingBiogenic with Advisement about GLEC 4 --- specs/index.bs | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/specs/index.bs b/specs/index.bs index 47c64f8..dba6e4f 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -2021,9 +2021,10 @@ Note: Section [[#appendix-b-sf-example]] contains an example. This property is OPTIONAL in the [[!PACTDX]] data Model. - It SHOULD be set to the total logistics emissions of the shipment, - including biogenic emissions, calculated by taking the sum of the <{TCE/co2eWTW}> over all TCEs (<{ShipmentFootprint/tces}>). + It SHOULD be kept undefined. + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint `fossilGhgEmissions` @@ -2040,7 +2041,7 @@ Note: Section [[#appendix-b-sf-example]] contains an example. CarbonFootprint `biogenicCarbonContent` - see the specification for `pCfIncludingBiogenic` in this table + see the specification for `pCfExcludingBiogenic` in this table CarbonFootprint @@ -2165,8 +2166,10 @@ Note: Section [[#appendix-b-toc-example]] contains an example. This property is OPTIONAL in the [[!PACTDX]] data Model. - It SHOULD be set to the logistics emissions intensity of the TOC, - including biogenic emissions, found in <{TOC/co2eIntensityWTW}>. + It SHOULD be kept undefined. + + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint @@ -2184,7 +2187,7 @@ Note: Section [[#appendix-b-toc-example]] contains an example. CarbonFootprint `biogenicCarbonContent` - see the specification for `pCfIncludingBiogenic` in this table + see the specification for `pCfExcludingBiogenic` in this table CarbonFootprint @@ -2312,8 +2315,10 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. This property is OPTIONAL in the [[!PACTDX]] data Model. - It SHOULD be set to the logistics emissions intensity of the HOC, - including biogenic emissions, found in <{HOC/co2eIntensityWTW}>. + It SHOULD be kept undefined. + + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint @@ -2331,7 +2336,7 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. CarbonFootprint `biogenicCarbonContent` - see the specification for `pCfIncludingBiogenic` in this table + see the specification for `pCfExcludingBiogenic` in this table CarbonFootprint From 777c49a9668a466f38371d46ed5902c0d365f4ef Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Mon, 26 Aug 2024 17:19:40 +0100 Subject: [PATCH 3/7] feat: initial proposal on how to improve integration chapter --- specs/index.bs | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/specs/index.bs b/specs/index.bs index dba6e4f..20f33cd 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -2175,19 +2175,19 @@ Note: Section [[#appendix-b-toc-example]] contains an example. CarbonFootprint `fossilGhgEmissions` - see the specification for `pCfExcludingBiogenic` in this table + Note: see the specification for `pCfIncludingBiogenic` in this table CarbonFootprint `fossilCarbonContent` - see the specification for `pCfExcludingBiogenic` in this table + Note: see the specification for `pCfIncludingBiogenic` in this table CarbonFootprint `biogenicCarbonContent` - see the specification for `pCfExcludingBiogenic` in this table + Note: see the specification for `pCfIncludingBiogenic` in this table CarbonFootprint @@ -2324,19 +2324,19 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. CarbonFootprint `fossilGhgEmissions` - see the specification for `pCfExcludingBiogenic` in this table + Note: see the specification for `pCfExcludingBiogenic` in this table CarbonFootprint `fossilCarbonContent` - see the specification for `pCfExcludingBiogenic` in this table + Note: see the specification for `pCfExcludingBiogenic` in this table CarbonFootprint `biogenicCarbonContent` - see the specification for `pCfExcludingBiogenic` in this table + Note: see the specification for `pCfIncludingBiogenic` in this table CarbonFootprint From e1a70edf2bfa8865bc31bf0f808cbb4b7c67c700 Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Tue, 3 Sep 2024 13:56:09 +0100 Subject: [PATCH 4/7] chore: add indication that productMassPerDeclaredUnit will become mandatory --- specs/index.bs | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/specs/index.bs b/specs/index.bs index 20f33cd..3fe7adc 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -2005,7 +2005,9 @@ Note: Section [[#appendix-b-sf-example]] contains an example. CarbonFootprint `productMassPerDeclaredUnit` - MUST equal the mass of the shipment (<{ShipmentFootprint/mass}>) + This property is OPTIONAL in the [[!PACTDX]] data Model but will become MANDATORY in v3. + + MUST equal the mass of the shipment (<{ShipmentFootprint/mass}>). CarbonFootprint @@ -2041,7 +2043,10 @@ Note: Section [[#appendix-b-sf-example]] contains an example. CarbonFootprint `biogenicCarbonContent` - see the specification for `pCfExcludingBiogenic` in this table + SHOULD be set to `"0"` + + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint @@ -2151,6 +2156,8 @@ Note: Section [[#appendix-b-toc-example]] contains an example. CarbonFootprint `productMassPerDeclaredUnit` + This property is OPTIONAL in the [[!PACTDX]] data Model but will become MANDATORY in v3. + MUST be set to `"1"`. @@ -2187,7 +2194,10 @@ Note: Section [[#appendix-b-toc-example]] contains an example. CarbonFootprint `biogenicCarbonContent` - Note: see the specification for `pCfIncludingBiogenic` in this table + SHOULD be set to `"0"` (zero encoded as a string) + + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint @@ -2296,6 +2306,8 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. CarbonFootprint `productMassPerDeclaredUnit` + This property is OPTIONAL in the [[!PACTDX]] data Model but will become MANDATORY in v3. + MUST be set to `"1000"`. @@ -2336,7 +2348,10 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. CarbonFootprint `biogenicCarbonContent` - Note: see the specification for `pCfIncludingBiogenic` in this table + SHOULD be set to `"0"` (zero encoded as a string) + + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint From 7678e7a1dfde06f80639339ea49fc552831c54b1 Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Tue, 3 Sep 2024 14:10:16 +0100 Subject: [PATCH 5/7] feat: set packagingEmissionsIncluded to false for ShipmentFootprint --- specs/index.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specs/index.bs b/specs/index.bs index 3fe7adc..7b834be 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -2054,7 +2054,7 @@ Note: Section [[#appendix-b-sf-example]] contains an example. see [[!PACTDX]] for further details - Issue: this property is pending input from the tech workshop(s) + MUST be set to `false`. CarbonFootprint From b81012f669a470ac89f87a5e92f328714d8f1b97 Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Thu, 5 Sep 2024 10:51:11 +0100 Subject: [PATCH 6/7] chore: update pCfExcludingBiogenic guidance def --- specs/index.bs | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/specs/index.bs b/specs/index.bs index 7b834be..6d85750 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -2013,10 +2013,11 @@ Note: Section [[#appendix-b-sf-example]] contains an example. CarbonFootprint `pCfExcludingBiogenic` - MUST be set to the total logistics emissions of the shipment, excluding biogenic emissions, - calculated by taking the sum of the <{TCE/co2eWTW}> over all TCEs (<{ShipmentFootprint/tces}>). - + MUST be set to the total logistics emissions of the shipment calculated by taking the sum of the <{TCE/co2eWTW}> + over all TCEs (<{ShipmentFootprint/tces}>). + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint `pCfIncludingBiogenic` @@ -2164,8 +2165,10 @@ Note: Section [[#appendix-b-toc-example]] contains an example. CarbonFootprint `pCfExcludingBiogenic` - MUST be set to the logistics emissions intensity of the TOC, excluding biogenic emissions, - defined in <{TOC/co2eIntensityWTW}>. + MUST be set to the logistics emissions intensity of the TOC defined in <{TOC/co2eIntensityWTW}>. + + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. CarbonFootprint @@ -2314,13 +2317,15 @@ Note: Section [[#appendix-b-hoc-example]] contains an example. CarbonFootprint `pCfExcludingBiogenic` - MUST be set to the logistics emissions intensity of the HOC, excluding biogenic emissions, - defined in <{HOC/co2eIntensityWTW}>. + MUST be set to the logistics emissions intensity of the HOC defined in <{HOC/co2eIntensityWTW}>. Note: The average weight of a container can be considered as 10 tonnes per `TEU`. For light containers, an estimate of 6 tonnes per `TEU` is appropriate, while heavy containers can be assumed to average 14.5 tonnes per `TEU`. + Advisement: Version 4 of the GLEC Framework will provide guidance on biogenic emissions. Updates to this property + will be made after its release. + CarbonFootprint `pCfIncludingBiogenic` From 6b042410527bb1c422b12b7fa82345af2fbfe8c0 Mon Sep 17 00:00:00 2001 From: Raimundo Henriques Date: Mon, 30 Sep 2024 13:05:13 +0200 Subject: [PATCH 7/7] chore: add changelog entry --- specs/index.bs | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/specs/index.bs b/specs/index.bs index 6d85750..7be04be 100644 --- a/specs/index.bs +++ b/specs/index.bs @@ -1,5 +1,9 @@ 
+<<<<<<< HEAD
 Title: iLEAP Technical Specifications (Version 0.2.1-20240903)
+=======
+Title: iLEAP Technical Specifications (Version 0.2.1-20240930)
+>>>>>>> e086402 (chore: add changelog entry)
 Shortname: ileap-extension
 Status: LD
 Status Text: Draft Technical Specification
@@ -2410,6 +2414,10 @@ properties that cannot be derived from `HOC` CAN be populated in a best-effort m
 
 # Appendix A: Changelog # {#changelog}
 
+## Version 0.2.1-20240930 (2024-09-30) ## {#version-20240930}
+
+- provide better guidance on [[#pcf-mapping]]
+
 ## Version 0.2.1-20240903 (2024-09-03) ## {#version-20240903}
 
 - make application of <{Location/iata}> and <{Location/uic}> more explicit