What would you like to be able to do?

mkdocs 1.6.0 can warn us about broken absolute links and broken anchors in links (#anchor). I would definitely like to try these new warnings on our docs, to help catch broken stuff before creating a new build of the docs.

But mkdocs-material does not support mkdocs 1.6.0 yet. So we need to wait for a version of mkdocs-material that support the new mkdocs.

Did you already have any implementation ideas?

Here's a list of todos:

• Upgrade to a version of mkdocs-material that supports mkdocs 1.6.0
• Read the mkdocs 1.6.0 changelog to check for important changes
• Update to mkdocs 1.6.0
• Try the new options for validation of hyperlinks between pages:
  • validate absolute links I think we should keep this set to absolute_links: warn so we're "forced" to use relative links.
  • validate anchors in links
  • Read the MkDocs validation section and try the recommended settings for most sites (maximal strictness):

    validation:
      omitted_files: warn
      absolute_links: warn  # Or 'relative_to_docs' - new in MkDocs 1.6
      unrecognized_links: warn
      anchors: warn  # New in MkDocs 1.6

I'm willing to try configuring the new settings for us, and helping to update. 😄

Do you want to write this feature yourself?

Yes