Enable headings in body text on document collections to appear in contents section

[unoduetre]

⚠️ This repo is Continuously Deployed: make sure you follow the guidance ⚠️

Follow these steps if you are doing a Rails upgrade.

What

Investigate whether we can enable headings in the body text to be included in the contents section, and if possible make it happen.

Why

The 'Contents' section of a document collection page is created automatically from the 'groups' of documents on the page. That works fine the majority of the time.

However, sometimes departments need to also link to documents or webpages that are relevant, but hosted off GOV.UK.

Because Whitehall doesn't let them add such links off the GOV.UK domain to 'groups', they have to add these to the body content of a page in the conventional way, under headings.

However, the H2s in the body content of a collection page are not made part of the 'Contents' list. This means that the contents list doesn't properly reflect the structure of the webpage.

Having the contents list reflect all of the page's H2s would make the collection page template consistent with detailed guides and publications.

Examples

• https://www.gov.uk/government/collections/technical-guidance-for-regulated-industry-sectors-environmental-permitting (The H2s on ‘Combustion activities’, ‘Food and drink’ and ‘Paper, pulp and cardboard manufacturing’ aren’t in the contents because they’re in the body text to link to material published off the GOV.UK domain.)
• https://whitehall-admin.publishing.service.gov.uk/government/admin/collections/1381479 (currently in draft)

Trello card

[hannako]

Nice!