Include files use absolute links which generate lots of warnings

[toomanybrians]

Originally posted by @worldpeace-germany in #482 (comment)

I cloned the repro and running the server with the docs locally throws hundreds of message because of absolute links. From my point of view all these messages might make it hard to see real issues. Most of these links are inside the includes. Is there something we can do about it? Just changing them to relative links might break it. Do we need the includes, makes it live really that much easier?

[toomanybrians]

I think the includes are used a lot. I guess we don’t absolutely need them, but then there would be lots of repeated text so anyone who updated that text would need to find and replace across many files.

I wonder if it’s possible to specific some kind of config option in mkdocs to suppress those types of warnings? I’ll keep this issue open to investigate

[worldpeace-germany]

Cross reference #538