Add guidance, update schema descriptions, add taxonomy mappings, replace normative keywords

[odscjen]

Related issues

• Closes #149
• Closes #187
• Addresses #2 and replaces the branch 2-AddHazardMappings
• Closes #156
• Closes #184

Description

• Add content to docs/guides/metadata.md
• Add link to dataset identifier guidance in the description of id
• Clarify the purpose of links
• Fix formatting in developer_docs.md
• Add taxonomy mapping content per https://github.com/GFDRR/rdl-standard/issues/2#issuecomment-1698090168
• Update examples for latest schema
• Replace normative keywords that appear in non-normative content with non-normative synonyms

Merge checklist

If you added, removed or renamed a field:

• [ ] Update the collapse option of the jsonschema directives for dataset, resource, hazard, exposure, vulnerability and loss on reference/schema.md
• [ ] Update the diagrams in reference/schema/md
• [ ] Update the JSON files in examples

Always:

• [x] Run ./manage.py pre-commit
• [x] Update the changelog (style guide)

Having trouble?

See how to resolve check failures.

[odscjen]

I've just converted that gdoc into actual markdown, @odscrachel (realised I should have mentioned this to you a minute ago) can make any of the changes you think are necessary while I'm off.

[duncandewhurst]

I didn't get a chance to review the content in the Google Doc so I've copy-edited the Markdown files directly.

I'm happy for this to be merged as-is so I'll request a review from Stu and Mat.

[duncandewhurst]

I see a :+1: from @stufraser1 on https://github.com/GFDRR/rdl-standard/issues/149#issuecomment-1704475567 so I figure this is good to merge. If needed, we can make changes in a separate PR.