[#3] Update Embedded codelist descriptions

https://docs.google.com/spreadsheets/d/1gVpcS8DR_-QDB8pxKdPHRuuRPmWs1yIWfBaGAhXDwew

xml/ActivityDateType.xml

@@ -1,31 +1,38 @@
-<codelist name="ActivityDateType"   xml:lang="en" complete="1">
+<codelist name="ActivityDateType" xml:lang="en" complete="1">
     <metadata>
         <name>Activity Date Type</name>
-        <description>Types of date for activities</description>
+        <description>
+            Types of date for activities.
+
+            There are many different business models and dates that can be used
+            to describe the start and end of activities. It is recommended that
+            each publisher adopts their own consistent approach that provides
+            users with a meaningful indication of the lifespan of an activity.
+        </description>
     </metadata>
     <codelist-items>
         <codelist-item>
             <code>1</code>
             <name>Planned start</name>
-            <description>The planned start date as recorded in project documentation. Can be date of signature of activity agreement or approval by relevant body</description>
+            <description>The actual date the activity starts, for example the date of the first disbursement or when physical activity starts.</description>
             <name xml:lang="fr">Début prévu</name>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Planned end</name>
-            <description>The planned end date as recorded in project documentation</description>
+            <description>The actual date the activity ends, for example the date of the last disbursement or when physical activity is complete.</description>
             <name xml:lang="fr">Fin prévue</name>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Actual start</name>
-            <description>The actual start date, such as date of first disbursement</description>
+            <description>The date on which the activity is planned to start, for example the date of the first planned disbursement or when physical activity starts.</description>
             <name xml:lang="fr">Début réel</name>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>Actual end</name>
-            <description>The actual end date, such as date of last disbursement</description>
+            <description>The date on which the activity is planned to end, for example the date of the last planned disbursement or when physical activity is complete.</description>
             <name xml:lang="fr">Fin réelle</name>
         </codelist-item>
     </codelist-items>

xml/ActivityScope.xml

@@ -1,4 +1,4 @@
-<codelist name="ActivityScope"   xml:lang="en" complete="1">
+<codelist name="ActivityScope" xml:lang="en" complete="1">
     <metadata>
         <name>Activity Scope</name>
         <description>Geographic scope of activity</description>
@@ -7,34 +7,42 @@
         <codelist-item>
             <code>1</code>
             <name>Global</name>
+            <description>The activity scope is global</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Regional</name>
+            <description>The activity scope is a supranational region</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Multi-national</name>
+            <description>The activity scope covers multiple countries, that don't constitute a region</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>National</name>
+            <description>The activity scope covers one country</description>
         </codelist-item>
         <codelist-item>
             <code>5</code>
             <name>Sub-national: Multi-first-level administrative areas</name>
+            <description>The activity scope covers more than one first-level subnational administrative areas (e.g. counties, provinces, states)</description>
         </codelist-item>
         <codelist-item>
             <code>6</code>
             <name>Sub-national: Single first-level administrative area</name>
+            <description>The activity scope covers one first-level subnational administrative area (e.g. country, province, state)</description>
         </codelist-item>
         <codelist-item>
             <code>7</code>
             <name>Sub-national: Single second-level administrative area</name>
+            <description>The activity scope covers one second-level subnational administrative area (e.g. municipality or district)</description>
         </codelist-item>
         <codelist-item>
             <code>8</code>
             <name>Single location</name>
+            <description>The activity scope covers one single location (e.g. town, village, farm)</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/ActivityStatus.xml

@@ -1,4 +1,4 @@
-<codelist name="ActivityStatus"   xml:lang="en" complete="1">
+<codelist name="ActivityStatus" xml:lang="en" complete="1">
     <metadata>
         <name>Activity Status</name>
         <description>Lifecycle status of the activity from pipeline to completion</description>
@@ -8,31 +8,37 @@
             <code>1</code>
             <name>Pipeline/identification</name>
             <name xml:lang="fr">Planification</name>
+            <description>The activity is being scoped or planned </description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Implementation</name>
             <name xml:lang="fr">Actif</name>
+            <description>The activity is currently being implemented</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Completion</name>
             <name xml:lang="fr">Finalisation</name>
+            <description>Physical activity is complete or the final disbursement has been made.</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>Post-completion</name>
             <name xml:lang="fr">Fermé</name>
+            <description>Physical activity is complete or the final disbursement has been made, but the activity remains open pending financial sign off or M&amp;E</description>
         </codelist-item>
         <codelist-item>
             <code>5</code>
             <name>Cancelled</name>
             <name xml:lang="fr">Annulé</name>
+            <description>The activity has been cancelled</description>
         </codelist-item>
         <codelist-item>
             <code>6</code>
             <name>Suspended</name>
             <name xml:lang="fr">Suspendu</name>
+            <description>The activity has been temporarily suspended</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/BudgetIdentifierVocabulary.xml

@@ -1,27 +1,32 @@
-<codelist name="BudgetIdentifierVocabulary"   xml:lang="en" complete="1">
+<codelist name="BudgetIdentifierVocabulary" xml:lang="en" complete="1">
     <metadata>
         <name>Budget Identifier Vocabulary</name>
     </metadata>
     <codelist-items>
         <codelist-item>
             <code>1</code>
             <name>IATI</name>
+            <description>The budget identifier reported uses IATI budget identifier categories</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Country Chart of Accounts</name>
+            <description>The budget identifier reported corresponds to the recipient country chart of accounts</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Other Country System</name>
+            <description>The budget identifier reported corresponds to a recipient country system other than the chart of accounts</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>Reporting Organisation</name>
+            <description>The budget identifier reported corresponds to categories that are specific to the reporting organisation</description>
         </codelist-item>
         <codelist-item>
             <code>5</code>
             <name>Other</name>
+            <description>The budget identifier reported uses a different vocabulary, not specified in the codelist </description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/BudgetType.xml

@@ -1,4 +1,4 @@
-<codelist name="BudgetType"   xml:lang="en" complete="1">
+<codelist name="BudgetType" xml:lang="en" complete="1">
     <metadata>
         <name>Budget Type</name>
         <description>OECD DAC classification used to determine the character of resource flows (bilateral or multilateral).</description>
@@ -8,11 +8,13 @@
             <code>1</code>
             <name>Original</name>
             <name xml:lang="en">Original</name>
+            <description>The original budget allocated to the activity</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Revised</name>
             <name xml:lang="fr">Révisé</name>
+            <description>The updated budget for an activity</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/CRSAddOtherFlags.xml

@@ -1,4 +1,4 @@
-<codelist name="CRSAddOtherFlags"   xml:lang="en" complete="1">
+<codelist name="CRSAddOtherFlags" xml:lang="en" complete="1">
     <metadata>
         <name>CRS Additional Other Flags</name>
         <description>OECD DAC classification used to distinguish aid modalities. </description>
@@ -7,18 +7,22 @@
         <codelist-item>
             <code>1</code>
             <name>Free standing technical cooperation</name>
+            <description>Free standing technical cooperation (Col 24 in CRS++ Reporting format)</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Programme-based approach</name>
+            <description>Programme-based approach (Col 25 in CRS++ Reporting format)</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Investment project</name>
+            <description>Investment project (Col 26 in CRS++ Reporting format)</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>Associated financing</name>
+            <description>Associated financing (Col 27 in CRS++ Reporting format)</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/ConditionType.xml

@@ -1,4 +1,4 @@
-<codelist name="ConditionType"   xml:lang="en" complete="1">
+<codelist name="ConditionType" xml:lang="en" complete="1">
     <metadata>
         <name>Condition Type</name>
         <description>Condition type – e.g. policy, performance.</description>
@@ -7,14 +7,17 @@
         <codelist-item>
             <code>1</code>
             <name>Policy</name>
+            <description>The condition attached requires a particular policy to be implemented by the recipient</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Performance</name>
+            <description>The condition attached requires certain outputs or outcomes to be achieved by the recipient</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Fiduciary</name>
+            <description>The condition attached requires use of certain public financial management or public accountability measures by the recipient</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/ContactType.xml

@@ -1,23 +1,27 @@
-<codelist name="ContactType"   xml:lang="en" complete="1">
+<codelist name="ContactType" xml:lang="en" complete="1">
     <metadata>
         <name>Contact Type</name>
     </metadata>
     <codelist-items>
         <codelist-item>
             <code>1</code>
             <name>General Enquiries</name>
+            <description>General Enquiries</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Project Management</name>
+            <description>Project Management</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Financial Management</name>
+            <description>Financial Management</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>Communications</name>
+            <description>Communications</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/DescriptionType.xml

@@ -1,4 +1,4 @@
-<codelist name="DescriptionType"   xml:lang="en" complete="1">
+<codelist name="DescriptionType" xml:lang="en" complete="1">
     <metadata>
         <name>Description Type</name>
         <description>Activity decription types. (General, objectives, etc)</description>
@@ -8,19 +8,19 @@
             <code>1</code>
             <name>General</name>
             <name xml:lang="fr">Général</name>
-            <description>Long description of the activity with no particular structure</description>
+            <description>Unstructured, long description of the activity </description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Objectives</name>
             <name xml:lang="fr">Objectifs</name>
-            <description>Objectives for the activity, for example from a logical framework</description>
+            <description>Specific objectives for the activity, e.g. taken from logical framework</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Target Groups</name>
             <name xml:lang="fr">Groupes cibles</name>
-            <description>Statement of groups targeted to benefit from the activity</description>
+            <description>Details of groups that are intended to benefit from the activity</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>

xml/DisbursementChannel.xml

@@ -1,4 +1,4 @@
-<codelist name="DisbursementChannel"   xml:lang="en" complete="1">
+<codelist name="DisbursementChannel" xml:lang="en" complete="1">
     <metadata>
         <name>Disbursement Channel</name>
         <description>Categories of information included in published documents</description>
@@ -7,18 +7,22 @@
         <codelist-item>
             <code>1</code>
             <name>Money is disbursed through central Ministry of Finance or Treasury</name>
+            <description>Money is disbursed through central Ministry of Finance or Treasury</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Money is disbursed directly to the implementing institution and managed through a separate bank account</name>
+            <description>Money is disbursed directly to the implementing institution and managed through a separate bank account</description>
         </codelist-item>
         <codelist-item>
             <code>3</code>
             <name>Aid in kind: Donors utilise third party agencies, e.g. NGOs or management companies</name>
+            <description>Aid in kind: Donors utilise third party agencies, e.g. NGOs or management companies</description>
         </codelist-item>
         <codelist-item>
             <code>4</code>
             <name>Aid in kind: Donors manage funds themselves</name>
+            <description>Aid in kind: Donors manage funds themselves</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/DocumentCategory-category.xml

@@ -7,10 +7,12 @@
         <codelist-item>
             <code>A</code>
             <name>Activity Level</name>
+            <description>The document is relevant to a specific activity</description>
         </codelist-item>
         <codelist-item>
             <code>B</code>
             <name>Organisation Level</name>
+            <description>The document is relevant to the organisation as a whole</description>
         </codelist-item>
     </codelist-items>
 </codelist>

xml/GazetteerAgency.xml

@@ -1,4 +1,4 @@
-<codelist name="GazetteerAgency"   xml:lang="en" complete="1">
+<codelist name="GazetteerAgency" xml:lang="en" complete="1">
     <metadata>
         <name>Gazetteer Agency</name>
         <description>An online resource that holds coordinates and descriptions of geographic locations </description>

xml/GeographicExactness.xml

@@ -1,16 +1,18 @@
 <codelist name="GeographicExactness" xml:lang="en" complete="1">
     <metadata>
         <name>Geographic Exactness</name>
-        <description></description>
+        <description/>
     </metadata>
     <codelist-items>
         <codelist-item>
             <code>1</code>
             <name>Exact</name>
+            <description>The designated geographic location is exact</description>
         </codelist-item>
         <codelist-item>
             <code>2</code>
             <name>Approximate</name>
+            <description>The designated geographic location is approximate</description>
         </codelist-item>
     </codelist-items>
 </codelist>