Links in headings render incorrectly in OTP

[shainaraskas]

Describe the bug

Some headings were migrated with links (probably a bad practice)

These headings get weird rendering in the OTP nav (and very long anchors)

https://bookish-dollop-9p66716.pages.github.io/docker.html#_windows_and_macos_with_docker_desktophttpswww_docker_comproductsdocker_desktop

Expected behavior

Either enforce stripping of links from headings (maybe with linting)

or

Strip links in OTP

This problem might go away if we lessen the number of levels we show in the OTP

Steps to reproduce

No response

Tooling

• docs-builder
• migration tooling
• I'm not sure

[bmorelli25]

Either enforce stripping of links from headings (maybe with linting)

I'm in favor of this option. I don't think linking from a heading should be allowed.

[bmorelli25]

This also appears to be an edge case with minimal impact. We likely won't prioritize this in the migration tool.

[reakaleek]

This will also be fixed by #290 because any markdown will be stripped from the title in the navigation.