Fix 404'ing links

[jasonmadigan]

• Fix some broken links
• Alter build to use -s mkdocs build (strict mode - fails on WARNING)
• Alter some absolute links to be relative

Example warnings:

WARNING -  Doc file 'authorino/docs/features.md' contains a relative link '../install/crd/authorino.kuadrant.io_authconfigs.yaml', but the target
           'authorino/install/crd/authorino.kuadrant.io_authconfigs.yaml' is not found among documentation files.
WARNING -  Doc file 'authorino/docs/user-guides/deny-with-redirect-to-login.md' contains a relative link 'user-guides/http-basic-authentication.md', but the target
           'authorino/docs/user-guides/user-guides/http-basic-authentication.md' is not found among documentation files.
INFO    -  Doc file 'limitador/README.md' contains an absolute link '/doc/how-it-works.md', it was left as is.
INFO    -  Doc file 'limitador/README.md' contains an unrecognized relative link 'limitador-server/kubernetes/', it was left as is. Did you mean
           'limitador-server/kubernetes/README.md'?
INFO    -  Doc file 'limitador/README.md' contains an unrecognized relative link 'LICENSE', it was left as is.
WARNING -  Doc file 'limitador/limitador-server/README.md' contains a relative link 'examples/limits.yaml', but the target
           'limitador/limitador-server/examples/limits.yaml' is not found among documentation files.
WARNING -  Doc file 'limitador/limitador-server/README.md' contains a relative link 'examples/envoy.yaml', but the target
           'limitador/limitador-server/examples/envoy.yaml' is not found among documentation files.

[jasonmadigan]

Repos affected (so far):

• docs.kuadrant.io
• multicluster-gateway-controller
• authorino
• limitador-operator
• architecture
• limitador
• kuadrant-operator

[jasonmadigan]

#57
Kuadrant/authorino#456
Kuadrant/multicluster-gateway-controller#778
Kuadrant/limitador-operator#123
Kuadrant/limitador#259
Kuadrant/architecture#52
Kuadrant/kuadrant-operator#408

[jasonmadigan]

PRs created

[jasonmadigan]

#57 - this will remain on hold for the time-being.

Need new releases for various upstream components, and this change isn't really enough to justify new builds of all of the components here. Changes are landed on main for these, so when these changes get released over time, we should eventually be able to land this and turn strict builds on.

Will track the status of these in this issue - one these all get bumps, this can land:

• kuadrant-operator > v0.6.0
  • v0.6.1 is in draft form, but doesn't (currently) incorporate [docs] Fixing some broken links kuadrant-operator#408
• authorino > v0.16.0
  • Waiting on next release: https://github.com/Kuadrant/authorino/releases/
  • Needs to include: [docs] Fixing some broken links authorino#456
  • Fixed in https://github.com/Kuadrant/authorino/releases/tag/v0.17.0
• limitador > v1.3.0
  • Waiting on next release: https://github.com/Kuadrant/limitador/releases
  • Needs to include: [docs] Fixing some broken links limitador#259
• limitador-operator > v0.7.0
  • Waiting on next release: https://github.com/Kuadrant/limitador-operator/releases
  • Needs to include: [docs] Fixing some broken links limitador-operator#123
• multicluster-gateway-controller > release-0.3
  • Waiting on next release: https://github.com/Kuadrant/multicluster-gateway-controller/releases
  • Needs to include: [docs] Fixing some broken links multicluster-gateway-controller#778
• architecture
  • Already points at main

[jasonmadigan]

Resolved a few weeks back, docs builds are with mkdocs -s now