docs: Restructure and update landing page content

[duncandewhurst]

Related issues

• Related to [Docs update] Restructuring the docs #43
• Closes [Docs update] Remove GED4all exposure taxonomy page #159
• Related to [Taxonomies] Add explanation to Hazard taxonomies section about RDL taxonomy becoming codelists #155
• Related to [Docs update] Check for and remove duplication across pages #154
• Related to [Docs update] Write content for Guides/RDL metadata page #149

Description

This PR implements the structure and landing page content proposed in #43 (comment). Notably, that includes integrating the content from the old taxonomies and GED4ALL pages into the 'other standards' page and linking to it from the relevant sections of the codelist and schema reference pages. It also includes a first draft of content for the new pages in the introduction section: 'What is the RDLS?' and 'How do I implement the RDLS?'. The latter page will need to be updated once the spreadsheet template and conversion and validation tool are available online and once the how-to guide for publishing RDLS metadata is written.

Merge checklist

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

If you added or removed a field:

• Update the collapse option of the jsonschema directives for dataset, resource, hazard, exposure, vulnerability and loss on reference/schema.md

Having trouble?

See how to resolve check failures.

[duncandewhurst]

These changes are probably easier to review in the built documentation: https://rdl-standard.readthedocs.io/en/43-restructure/

[odscjen]

@duncandewhurst I merged the latest dev branch into this PR and it's caused a readthedocs failure. Running this on my own machine there was a typo introduced in reference/schema.md but fixing that made the build work properly so I'm not sure why it's now failing here

[matamadio]

Flow of information is more intuitive now.

[duncandewhurst]

@duncandewhurst I merged the latest dev branch into this PR and it's caused a readthedocs failure. Running this on my own machine there was a typo introduced in reference/schema.md but fixing that made the build work properly so I'm not sure why it's now failing here

Ah, the reason was that this PR added a new instance of the jsonschema directive on docs/rdl/what.md, which referenced rdl_schema_0.1.json that had been renamed on dev. The reason it built OK locally is because the directive links to the built version of the schema, which would have still been available on your local machine unless you first ran make clean to delete the build folder. Whereas, on Read the Docs, the docs are built on a fresh virtual machine each time. I've fixed the link in 1aece4b

[duncandewhurst]

@matamadio are you happy for me to merge this or do you want to wait for @stufraser1 to review?

[duncandewhurst]

Agreed to merge in call with @matamadio