Metadata format - sustainabledevelopment-rwanda/sdg-indicators-archived GitHub Wiki

Introduction

When editing metadata, the individual fields are associated with a particular tag. This page details what each of those tags represents. This is mostly relevant for developers of the site, but users will also find it useful if they are adding additional "Raw Metadata" in the Prose interface.

For metadata guidance and troubleshooting, please visit sustainabledevelopment-rwanda/sdg-data.

Mandatory fields

Already populated from UN.STAT

Indicator name MANDATORY

Target name MANDATORY

Target number MANDATORY

UN designated tier RECOMMENDED

UN custodian agency RECOMMENDED

Link to UN metadata RECOMMENDED

Link to UN metadata text RECOMMENDED

Require populating

Geographical coverage MANDATORY

Unit of measurement MANDATORY

Reporting status (needs to be complete')' MANDATORY

Graph type (line by default) MANDATORY

Graph title MANDATORY

data_non_statistical (true/false) MANDATORY

Source 1 active (checkbox) RECOMMENDED

Source 1: Organisation RECOMMENDED

Source 1: Link to data source RECOMMENDED

Source 1: Link to data source text RECOMMENDED

The rest are optional fields (incl. data sources 2-6)

Metadata Groups

National Metadata

Tag Description
national_indicator_available Actual indicator available
national_indicator_description Actual indicator description
national_indicator_periodicity Indicator periodicity
national_earliest_available_data Earliest available data
national_geographical_coverage Geographic coverage
admin_release_date Release date
admin_next_release Next release date
admin_statistical_classification Statistical classification
computation_disaggregation Disaggregation
comments_limitations Comments and limitations
admin_contact_details Contact details

Method of Computation Metadata

Tag Description
computation_units Units of Measure
computation_calculations Calculations
computation_numerator Numerator
computation_denominator Denominator

Global Metadata

Tag Description
indicator_name Indicator name
indicator Indicator number
target Target name
target_id Target number
indicator_definition Global indicator description
un_designated_tier UN designated tier
un_custodial_agency UN custodial agency
goal_meta_link Link to UN metadata
goal_meta_link_text The text to show instead of the URL

Data Sources Metadata

These metadata tags for the sources are available for 3 separate sources at the moment (replace the # with a 1, 2 or 3).

Tag Description
source_active_# Binary indicator stating whether the source is availble - should be true or false
source_organisation_# Organisation
source_periodicity_# Periodicity
source_earliest_available_# Earliest available data
source_geographical_coverage_# Geographical coverage
source_url_# Link to data source
source_url_text_# The text to show instead of the URL
source_release_date_# Release date
source_next_release_# Next release date
source_statistical_classification_# Statistical classification
source_contact_# Contact details
source_other_info_# Other information

Data Info

These are not displayed on the website but affect how it is laid out.

Tag Description
reporting_status One of notstarted (red), or complete (green).
data_non_statistical true or false flag. Non-statistical data does not have csv or graphs.

Graph Metadata

Some additional tags are available for the graphs, including the graph type and the graph title. Currently only longitudinal graphs are available but more are planned. These tags are experimental. Graph tags do not show up on the web page as metadata; we will use them in the future for setting how a graphic should render, some extra labels etc.

Tag Description
graph_type One of line or bar
graph_title The title to be shown on the graph

Non-Standard Information

In the Prose editor, you can add free Markdown text in the same file as the metadata. This is the edit section in prose and is part of the metadata. In the raw .md file this is the content underneath the yaml header. You can add any content you like in this section and the content will be converted to html and placed above the graph near the top of the screen.

A guide to writing Markdown is here and you can write your own tables, lists, links, headings, and so on. This is a useful place to add information about an indicator that doesn't fit in with the rest of the metadata.