✨ Improve metadata in GDP data pages (#3930)

* ✨ Improve metadata in GDP data pages * ✨ improve WDI GDPs * 🐛 reference definitions in brackets correctly * ✨ update MPD metadata * 💄 remove short attribution from each variable * ✨ metadata PWT * ✨ gdp_historical and UNDP * ✨ add description_short and improve metadata in WDI and UNDP * ✨ description short + fixes for Maddison, PWT and mix * 🐛 fix extra bracket
owid · Feb 5, 2025 · a9873e9 · a9873e9
1 parent 4342deb
commit a9873e9
Show file tree

Hide file tree

Showing 6 changed files with 352 additions and 99 deletions.
diff --git a/etl/steps/data/garden/ggdc/2024-04-26/maddison_project_database.meta.yml b/etl/steps/data/garden/ggdc/2024-04-26/maddison_project_database.meta.yml
@@ -7,10 +7,21 @@ definitions:
       tolerance: 5
       entityAnnotationsMap: "Western offshoots (MPD): United States, Canada, Australia and New Zealand"
     presentation:
+      attribution_short: Maddison Project Database
       topic_tags:
         - Economic Growth
 
   description_key_attribution: The Maddison Project Database is based on the work of many researchers who have produced estimates of economic growth and population for individual countries. The full list of sources for this historical data is given in [the original dataset](https://dataverse.nl/api/access/datafile/421302).
+  description_key_gdp: Gross domestic product (GDP) is a measure of the total value added from the production of goods and services in a country or region each year.
+  description_key_gdp_per_capita: GDP per capita is GDP divided by population.
+  description_key_long_run: This indicator provides information on economic growth and income levels in the _very long run_. Some country estimates are available as far back as 1 CE, and regional estimates as far back as 1820 CE.
+  description_key_ppp_adjustment: This data is adjusted for inflation and for differences in living costs between countries.
+  description_key_ppp_prices: This data is expressed in [international-$](#dod:int_dollar_abbreviation) at 2011 prices, using a combination of 2011 and 1990 PPPs for historical data.
+  description_key_former: Time series for former countries and territories are calculated forward in time by estimating values based on their last official borders.
+
+  description_short_gdp: Total economic output of a country or region per year.
+  description_short_gdp_per_capita: Average economic output per person in a country or region per year.
+
 
 
 # Learn more about the available fields:
@@ -26,23 +37,23 @@ tables:
         title: Gross domestic product (GDP)
         unit: international-$ in 2011 prices
         short_unit: $
-        description_short: This data is adjusted for inflation and differences in the cost of living between countries.
+        description_short: "{definitions.description_short_gdp} {definitions.description_key_ppp_adjustment}"
         description_key:
           - "{definitions.description_key_attribution}"
-          - This GDP indicator provides information on economic growth and income levels in the very long run. Some country estimates are available as far back as 1 CE and regional estimates as far back as 1820 CE.
-          - This data is adjusted for inflation and for differences in the cost of living between countries.
-          - This data is expressed in [international-$](#dod:int_dollar_abbreviation) at 2011 prices, using a combination of 2011 and 1990 PPPs for historical data.
-          - Time series for former countries and territories are calculated forward in time by estimating values based on their last official borders.
-          - For more regularly updated estimates of GDP, see the [World Bank's indicator](https://ourworldindata.org/grapher/national-gdp-wb).
+          - "{definitions.description_key_gdp}"
+          - "{definitions.description_key_long_run}"
+          - "{definitions.description_key_ppp_adjustment}"
+          - "{definitions.description_key_ppp_prices}"
+          - "{definitions.description_key_former}"
+          - For more regularly updated estimates of GDP per capita since 1990, see the [World Bank's indicator](https://ourworldindata.org/grapher/gdp-worldbank).
         processing_level: major
         description_processing: Estimates of GDP are not provided directly from the source, so we obtained them by multiplying GDP per capita by population.
         display:
           name: GDP
           <<: *common-display
         presentation:
           title_public: Gross domestic product (GDP)
-          title_variant: Historical data
-          attribution_short: Maddison Project Database
+          title_variant: In constant international-$. Historical data
           faqs:
             - fragment_id: poverty-international-dollars
               gdoc_id: 1gGburArxglFdHXeTLotFW4TOOLoeRq5XW6UfAdKtaAw
@@ -57,7 +68,7 @@ tables:
             hideRelativeToggle: false
             hasMapTab: true
             tab: map
-            variantName: Maddison Project Database, constant international-$
+            variantName: In constant international-$. Historical data - Maddison Project Database
             originUrl: https://ourworldindata.org/economic-growth
             yAxis:
               min: 0
@@ -74,7 +85,7 @@ tables:
                   - 1000000000000
                   - 3000000000000
                   - 10000000000000
-                  - 30000000000000
+                  - 1
             selectedEntityNames:
               - United States
               - India
@@ -86,20 +97,21 @@ tables:
               - United Kingdom
               - France
               - Mexico
-            $schema: https://files.ourworldindata.org/schemas/grapher-schema.004.json
 
       gdp_per_capita:
         title: GDP per capita
         unit: international-$ in 2011 prices
         short_unit: $
-        description_short: This data is adjusted for inflation and differences in the cost of living between countries.
+        description_short: "{definitions.description_short_gdp_per_capita} {definitions.description_key_ppp_adjustment}"
         description_key:
           - "{definitions.description_key_attribution}"
-          - This GDP per capita indicator provides information on economic growth and income levels in the very long run. Some country estimates are available as far back as 1 CE and regional estimates as far back as 1820 CE.
-          - This data is adjusted for inflation and for differences in the cost of living between countries.
-          - This data is expressed in [international-$](#dod:int_dollar_abbreviation) at 2011 prices, using a combination of 2011 and 1990 PPPs for historical data.
-          - Time series for former countries and territories are calculated forward in time by estimating values based on their last official borders.
-          - For more regularly updated estimates of GDP per capita, see the [World Bank's indicator](https://ourworldindata.org/grapher/gdp-per-capita-worldbank).
+          - "{definitions.description_key_gdp} {definitions.description_key_gdp_per_capita}"
+          - "{definitions.description_key_long_run}"
+          - "{definitions.description_key_ppp_adjustment}"
+          - "{definitions.description_key_ppp_prices}"
+          - "{definitions.description_key_former}"
+          - For more regularly updated estimates of GDP per capita since 1990, see the [World Bank's indicator](https://ourworldindata.org/grapher/gdp-per-capita-worldbank).
+
         description_from_producer: |-
           Real GDP per capita in 2011$
 
@@ -127,8 +139,7 @@ tables:
           <<: *common-display
         presentation:
           title_public: GDP per capita
-          title_variant: Historical data
-          attribution_short: Maddison Project Database
+          title_variant: In constant international-$. Historical data
           faqs:
             - fragment_id: poverty-international-dollars
               gdoc_id: 1gGburArxglFdHXeTLotFW4TOOLoeRq5XW6UfAdKtaAw
@@ -161,7 +172,7 @@ tables:
                   - 10000
                   - 20000
                   - 50000
-                  - 100000
+                  - 1
             selectedEntityNames:
               - World
               - South and South-East Asia (MPD)
@@ -172,7 +183,6 @@ tables:
               - Middle East (MPD)
               - East Asia (MPD)
               - Western offshoots (MPD)
-            $schema: https://files.ourworldindata.org/schemas/grapher-schema.004.json
 
       population:
         title: Population
@@ -193,7 +203,6 @@ tables:
         presentation:
           title_public: Population
           title_variant: Historical data
-          attribution_short: Maddison Project Database
 
       region:
         title: Maddison Project Database region
@@ -208,5 +217,4 @@ tables:
         presentation:
           title_public: World regions according to Maddison Project Database
           title_variant: Historical data
-          attribution_short: Maddison Project Database
 
diff --git a/etl/steps/data/garden/growth/2024-05-16/gdp_historical.meta.yml b/etl/steps/data/garden/growth/2024-05-16/gdp_historical.meta.yml
@@ -4,17 +4,25 @@ definitions:
     presentation:
       topic_tags:
         - Economic Growth
-      title_variant: Historical data
-      attribution_short: World Bank, Maddison Project Database, Maddison Database
+      title_variant: In constant international-$. Historical data
+      attribution_short: Maddison Database, Maddison Project Database, World Bank
     processing_level: major
+    description_from_producer: ""
 
     description_processing: |-
-      The data presented here from 1990 onwards is from the World Bank. Data before 1990 is constructed using the 1990 World Bank observation and applying the growth rates implied by the Maddison Project Database. Similarly, data before 1820 is built using the adjusted 1820 estimate calculated by the previous method and applying the growth rates implied by the Maddison Database. These steps are necessary because World Bank data adjusted for inflation and the cost of living between countries is only available from 1990 onwards and also because the three datasets estimate GDP with different prices.
+      The data presented here from 1990 onwards is from the World Bank. We constructed the data before 1990 using the 1990 World Bank observation and applying the growth rates implied by the Maddison Project Database. Similarly, we built the data before 1820 using the adjusted 1820 estimate calculated by the previous method and applying the growth rates implied by the Maddison Database. These steps are necessary because World Bank data adjusted for inflation and the cost of living between countries is only available from 1990 onwards and also because the three datasets estimate GDP with different prices.
 
-      The adjusted results before 1990 have been rounded to address uncertainty in the underlying data. GDP data is rounded to the nearest million, and GDP is rounded to the nearest hundred.
+      We rounded the adjusted results before 1990 to address uncertainty in the underlying data. We rounded GDP data to the nearest million, and GDP to the nearest hundred.
 
-  description_adjustment: This data is adjusted for inflation and for differences in the cost of living between countries.
-  description_unit_merge: This data is expressed in [international-$](#dod:int_dollar_abbreviation) at 2017 prices, merging data from the World Bank, backwards extended with growth rates from Maddison Project Database and Maddison Database.
+  description_gdp: Gross domestic product (GDP) is a measure of the total value added from the production of goods and services in a country or region each year.
+  description_gdp_per_capita: GDP per capita is GDP divided by population.
+  description_long_run_gdp: This global GDP indicator provides information on global economic growth and income levels in the very long run. Estimates are available as far back as 1 CE.
+  description_long_run_gdp_per_capita: This global average GDP per capita indicator provides information on global economic growth and income levels in the very long run. Estimates are available as far back as 1 CE.
+  description_ppp_adjustment: This data is adjusted for inflation and for differences in living costs between countries.
+  description_ppp_prices: This data is expressed in [international-$](#dod:int_dollar_abbreviation) at 2021 prices, combining data from the Maddison Database, Maddison Project Database, and World Bank.
+
+  description_short_gdp: Total economic output of the world economy.
+  description_short_gdp_per_capita: Average economic output per person in the world economy.
 
 
 # Learn more about the available fields:
@@ -38,12 +46,12 @@ tables:
         display:
           name: GDP
           numDecimalPlaces: 0
-        description_short: Total output of the world economy. This data is adjusted for inflation and differences in the cost
-          of living between countries.
+        description_short: "{definitions.description_gdp} {definitions.description_ppp_adjustment}"
         description_key:
-          - This GDP indicator provides information on global economic growth and income levels in the very long run. Estimates are available as far back as 1 CE.
-          - "{definitions.description_adjustment}"
-          - "{definitions.description_unit_merge}"
+          - "{definitions.description_gdp}"
+          - "{definitions.description_long_run_gdp}"
+          - "{definitions.description_ppp_adjustment}"
+          - "{definitions.description_ppp_prices}"
         presentation:
           title_public: Global GDP over the long run
           faqs:
@@ -74,11 +82,12 @@ tables:
         display:
           name: GDP per capita
           numDecimalPlaces: 0
-        description_short: This data is adjusted for inflation and differences in the cost of living between countries.
+        description_short: "{definitions.description_gdp_per_capita} {definitions.description_ppp_adjustment}"
         description_key:
-          - This GDP per capita indicator provides information on global economic growth and income levels in the very long run. Estimates are available as far back as 1 CE.
-          - "{definitions.description_adjustment}"
-          - "{definitions.description_unit_merge}"
+          - "{definitions.description_gdp} {definitions.description_gdp_per_capita}"
+          - "{definitions.description_long_run_gdp_per_capita}"
+          - "{definitions.description_ppp_adjustment}"
+          - "{definitions.description_ppp_prices}"
         presentation:
           title_public: Global average GDP per capita over the long run
           faqs:

diff --git a/etl/steps/data/garden/un/2024-04-09/undp_hdr.meta.yml b/etl/steps/data/garden/un/2024-04-09/undp_hdr.meta.yml
@@ -2,13 +2,22 @@ definitions:
   common:
     processing_level: minor
     presentation:
+      attribution_short: UNDP
       topic_tags:
         - Human Development Index (HDI)
       grapher_config:
         tab: map
         selectedEntityNames:
           - World
 
+  gni: Gross national income (GNI) is a measure of the total income earned by residents of a country or region each year. It is calculated as GDP plus net income received from abroad, plus taxes (minus subsidies) on production.
+  gni_per_capita: GNI per capita is GNI divided by population.
+  ppp_adjustment: This data is adjusted for inflation and for differences in living costs between countries.
+  ppp_prices: This data is expressed in [international-$](#dod:int_dollar_abbreviation) at 2017 prices.
+
+  description_short_gni: Total income earned by residents of a country or region, including income earned abroad.
+  description_short_gni_per_capita: Average income per person earned by residents of a country or region, including income earned abroad.
+
 # Learn more about the available fields:
 # http://docs.owid.io/projects/etl/architecture/metadata/reference/
 dataset:
@@ -405,7 +414,12 @@ tables:
         short_unit: $
         unit: international-$ in 2017 prices
         description_short: |-
-          Measures the total income earned by residents of a country, including income earned abroad. This data is adjusted for inflation and differences in the cost of living between countries.
+          "{definitions.description_short_gni_per_capita} {definitions.ppp_adjustment}"
+        description_key:
+          - "{definitions.gni} {definitions.gni_per_capita}"
+          - This GNI per capita indicator provides information on economic growth and income levels from 1990.
+          - "{definitions.ppp_adjustment}"
+          - "{definitions.ppp_prices}"
         description_from_producer: &description_prod_gnipc |-
           UNDP relies on IMF (2023), UNDESA (2023), United Nations Statistics Division (2023), World Bank (2023).
 
@@ -414,6 +428,8 @@ tables:
           For several countries without a value of GNI per capita in constant 2017 PPP terms for 20 22 reported in the World Development Indicators database, real growth rates of GDP per capita available in the World Development Indicators database or in the International Monetary Fund's Economic Outlook database are applied to the most recent GNI values in constant PPP terms.
 
           Official PPP conversion rates are produced by the International Comparison Program, whose surveys periodically collect thousands of prices of matched goods and services in many countries. The last round of this exercise refers to 2017 and covered 176 economies.
+        presentation:
+          title_variant: In constant international-$
       gni_pc_m:
         title: Gross national income per capita (male)
         short_unit: $