project-schema.json: add policyAlignment object and codelist

docs/_static/i18n.csv

@@ -407,3 +407,6 @@ completion/finalScopeDetails,Final scope details,True,
 language,Language,True,
 environment,Environment,False,
 environment/goals,Environmental goals,False,
+policyAlignment,Policy alignment,False,
+policyAlignment/policies,Policies,False,
+policyAlignment/description,Description,True,

docs/cost/ids/sustainability.md

@@ -837,7 +837,7 @@ Eg:
 :columns: 8
 OC4IDS mapping
 ^^^
-Project level: Add the relevant code from the environmentalGoal codelist to the `environment.goals` array
+Project level: Add the relevant codes from the environmentalGoal codelist to the `environment.goals` array
 ```json
 {
   "environment": {
@@ -965,7 +965,7 @@ Select from a list of international commitments and clarify how the project is a
 :columns: 8
 OC4IDS mapping
 ^^^
-See mapping for data point "Policy coherence" in Institutional extension adding the selected codes to the `policyAlighment.policies` array.
+See mapping for data point "Policy coherence" in Institutional extension adding the selected codes to the `policyAlignment.policies` array.
 ```json
 {
   "policyAlignment": {
@@ -1005,7 +1005,7 @@ Select from a list of international commitments and clarify how the project is a
 :columns: 8
 OC4IDS mapping
 ^^^
-See mapping for data point "Policy coherence" in Institutional extension adding `parisAgreement` to the `policyAlighment.policies` array.
+See mapping for data point "Policy coherence" in Institutional extension adding `parisAgreement` to the `policyAlignment.policies` array.
 ```json
 
 ```
@@ -2695,13 +2695,13 @@ OC4IDS mapping
 ^^^
 Project level:
 
-For each plan or policy to which the project is aligned, add a code from the policyAlignment codelist to the `.policyAlignment.policies` array. Add a further explanation of the project's policy alignment to `.policyAlignment.description`.
+For each plan or policy to which the project is aligned, add a code from the [policyAlignment](https://standard.open-contracting.org/infrastructure/%7B%7Bversion%7D%7D/%7B%7Blang%7D%7D/reference/codelists/#policyalignment) codelist to the `.policyAlignment.policies` array. Add a further explanation of the project's policy alignment to `.policyAlignment.description`.
 
 For each United Nations Sustainable Development Goal to which the project is aligned, add a `Classification` object to the `.additionalClassifications` array, set its `.scheme` to 'sdg', set its `.id` to the goal's number and set its `.description` to the goal's title.
 
 For each United Nations Sustainable Development Goal Target to which the project is aligned, add a `Classification` object to the `.additionalClassifications` array, set its `.scheme` to 'sdgTarget', set its `.id` to the target's number and set its `.description` to the target's title.
 
-If further documentation of the project's policy alignment is available, add a document with `.documentType` set to 'policyAlignment', `url` set to the URL at which the documentation can be accessed.
+If further documentation of the project's policy alignment is available, [Add a project document](../common.md#add-a-project-document) with `.documentType` set to 'policyAlignment', `url` set to the URL at which the documentation can be accessed.
 ```json
 {
   "additionalClassifications": [

docs/examples/blank.json

@@ -444,5 +444,11 @@
     "goals": [
       "string"
     ]
+  },
+  "policyAlignment": {
+    "policies": [
+      "string"
+    ],
+    "description": "string"
   }
 }

docs/examples/example.json

@@ -987,6 +987,12 @@
         "goals": [
           "climateChangeMitigation"
         ]
+      },
+      "policyAlignment": {
+        "policies": [
+          "infrastructurePlan"
+        ],
+        "description": "The project is intended to contribute towards the goals set out in the 2021 Australian Infrastructure Plan."
       }
     }
   ]

docs/reference/codelists.md

@@ -131,3 +131,10 @@ Projects with a `status` of 'completed' may be displayed in a list of archived p
 :header-rows: 1
 :file: ../../build/current_lang/codelists/classificationScheme.csv
 ```
+
+### policyAlignment
+
+```{csv-table-no-translate}
+:header-rows: 1
+:file: ../../build/current_lang/codelists/policyAlignment.csv
+```

mapping/sustainability.yaml

@@ -550,7 +550,7 @@
     module: Climate finance
     indicator: Policy coherence
     disclosure format: Select from a list of international commitments and clarify how the project is aligned with it \[codelist, free text to explain\].
-    mapping: See mapping for data point "Policy coherence" in Institutional extension adding the selected codes to the `policyAlighment.policies` array.
+    mapping: See mapping for data point "Policy coherence" in Institutional extension adding the selected codes to the `policyAlignment.policies` array.
     example: |-
         {
           "policyAlignment": {
@@ -574,7 +574,7 @@
     module: Climate finance
     indicator: Policy coherence
     disclosure format: Select from a list of international commitments and clarify how the project is aligned with it \[codelist, free text to explain\].
-    mapping: See mapping for data point "Policy coherence" in Institutional extension adding `parisAgreement` to the `policyAlighment.policies` array.
+    mapping: See mapping for data point "Policy coherence" in Institutional extension adding `parisAgreement` to the `policyAlignment.policies` array.
     example: ''
 -   id: '3.7'
     title: Beneficiaries
@@ -1631,13 +1631,13 @@
     mapping: |-
         Project level:
 
-        For each plan or policy to which the project is aligned, add a code from the policyAlignment codelist to the `.policyAlignment.policies` array. Add a further explanation of the project's policy alignment to `.policyAlignment.description`.
+        For each plan or policy to which the project is aligned, add a code from the [policyAlignment](https://standard.open-contracting.org/infrastructure/%7B%7Bversion%7D%7D/%7B%7Blang%7D%7D/reference/codelists/#policyalignment) codelist to the `.policyAlignment.policies` array. Add a further explanation of the project's policy alignment to `.policyAlignment.description`.
 
         For each United Nations Sustainable Development Goal to which the project is aligned, add a `Classification` object to the `.additionalClassifications` array, set its `.scheme` to 'sdg', set its `.id` to the goal's number and set its `.description` to the goal's title.
 
         For each United Nations Sustainable Development Goal Target to which the project is aligned, add a `Classification` object to the `.additionalClassifications` array, set its `.scheme` to 'sdgTarget', set its `.id` to the target's number and set its `.description` to the target's title.
 
-        If further documentation of the project's policy alignment is available, add a document with `.documentType` set to 'policyAlignment', `url` set to the URL at which the documentation can be accessed.
+        If further documentation of the project's policy alignment is available, [Add a project document](../common.md#add-a-project-document) with `.documentType` set to 'policyAlignment', `url` set to the URL at which the documentation can be accessed.
     example: |-
         {
           "additionalClassifications": [

schema/project-level/codelists/documentType.csv

@@ -64,3 +64,4 @@ contractAmendment,Contract amendment,A legal document that changes or adds to th
 designReport,Project design report,"A record of the justification for the design approach adopted in the project, typically issued before the works start, by the consultant or firm that will supervise the works.",OC4IDS
 paymentCertificate,Payment certificate,A document certifying that the work specified on a supplier's estimate or invoice is complete and that payment to the supplier is approved.,OC4IDS
 escalationApproval,Escalation approval,Documentation of one or more approved escalations of the contract price during the project life-cycle.,OC4IDS
+policyAlignment,Policy alignment,"Documentation detailing how a project aligns with an international, national, sector, or procuring entity policy, plan or strategy.",OC4IDS

schema/project-level/codelists/policyAlignment.csv

@@ -0,0 +1,10 @@
+Code,Title,Description,Source
+SDG,Sustainable development goals,"The Sustainable Development Goals are a collection of 17 interlinked goals set by the United Nations General Assembly and designed to be a ""blueprint to achieve a better and more sustainable future for all"".",OC4IDS
+nationalPlan,National plan or strategy,"National plans set out high-level goals and objectives, and the strategies by which these will be achieved. These are used to guide public investment at a national level.",OC4IDS
+infrastructurePlan,Infrastructure plan or strategy,"Infrastructure plans set out high-level goals and objectives, and the strategies by which these will be achieved. These are used to guide public investment in infrastructure.",OC4IDS
+sectorPlan,Sector plan or strategy,"Sector plans set out high-level goals and objectives, and the strategies by which these will be achieved. These are used to guide public investment in the named sector.",OC4IDS
+procurementPlan,Procurement plan or strategy,"Procurement plans set out the goods, services and works a procuring entity plans to procure over the defined time period.",OC4IDS
+parisAgreement,Paris agreement,"The Paris Agreement is a legally binding international treaty on climate change. It was adopted by 196 Parties at the UN Climate Change Conference (COP21) in Paris, France, on 12 December 2015.",OC4IDS
+nationallyDeterminedContribution,Nationally determined contribution,A Nationally Determined Contribution (NDC) is a climate action plan to cut emissions and adapt to climate impacts. Each Party to the Paris Agreement is required to establish an NDC and update it every five years.,OC4IDS
+nationalAdaptationPlan,National adaptation plan,"The National Adaptation Plan (NAPs) process was established under the Cancun Adaptation Framework (2010) in order to prepare countries for addressing climate risk in the medium term. The main objectives of the NAPs are to reduce vulnerability to climate change, and to mainstream climate change adaptation in all levels of planning.",OC4IDS
+mediumTermFiscalFramework,Medium-term fiscal framework,"A medium-term fiscal framework is a multiyear budget tool that combines expenditure ceilings, resource forecasts and baselines of ongoing expenditures.",OC4IDS

schema/project-level/project-schema.json

@@ -321,6 +321,32 @@
         }
       },
       "minProperties": 1
+    },
+    "policyAlignment": {
+      "title": "Policy alignment",
+      "description": "Information about how the project aligns with international, national and/or sectoral policies.",
+      "type": "object",
+      "properties": {
+        "policies": {
+          "title": "Policies",
+          "description": "The policies the project is in alignment with, using the open [policyAlignment](https://standard.open-contracting.org/infrastructure/{{version}}/{{lang}}/reference/codelists/#policyalignment) codelist.",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "type": "string"
+          },
+          "codelist": "policyAlignment.csv",
+          "openCodelist": true,
+          "minItems": 1
+        },
+        "description": {
+          "title": "Description",
+          "description": "A short description of how the project aligns with the policies listed in `.policies`.",
+          "type": "string"
+        }
+      },
+      "minProperties": 1
     }
   },
   "definitions": {