Add sustainability modules to mapping documentation

[duncandewhurst]

Related issues

• Closes Add sustainability modules to mapping documentation #395

Description

The mapping is stored in sustainability.yaml and there are two new manage.py commands:

• update-sustainability-docs generates the Markdown content in docs/cost/ids/sustainability.md using sustainability.yaml.
• lint formats and validates the data in sustainability.yaml and reports missing data

Presently, lint reports many additional fields and some missing data. This is expected because the schema is not yet updated and because the mapping for some elements is still under discussion.

However, I suggest that we merge this PR as-is and then, as part of each schema or codelist change PR, we can update the relevant mappings and examples in sustainability.yaml.

Before releasing, OC4IDS 0.9.4 we can do a final copy edit of the mappings and examples for consistency and check that lint reports no additional fields or missing data. I'll create a separate issue about that.

The spell-check is failing on the "TNE" unit code referenced in the mapping. @jpmckinney is there somewhere that needs to be added to a dictionary?

Merge checklist

• Log your changes

If there are changes to project-schema.json or project-package-schema.json:

• Update the examples:
  • docs/examples/example.json
  • docs/examples/blank.json
• Run ./manage.py pre-commit to update docs/_static/i8n.csv

If you added a new definition to the schema, run ./manage.py pre-commit.

If you added a new codelist:

• Add an entry to docs/reference/codelists.md

[jpmckinney]

For spellcheck, change -L zar to -L tne,zar in spellcheck.yml.

[jpmckinney]

Looks like a straight split of the content (i.e. without additional changes), plus the addition of the sustainability content (which will continue to change).

If that's the case, then my only comment is with heading levels having changed.

[duncandewhurst]

Looks like a straight split of the content (i.e. without additional changes), plus the addition of the sustainability content (which will continue to change).

Yep, that's correct.

[duncandewhurst]

I realised that docs/cost/ids/index.md was missing any content so I've added a description of its sub-pages. At the same time, I added introductory sentences to other pages under docs/cost and updated page titles to use sentence case.

[jpmckinney]

Just a few small changes, then good to merge :)

[jpmckinney]

Should this paragraph also be present in ocds.md?

[duncandewhurst]

Yes! Added in a198afb