Doc: Fix mkdocs broken requirement links in roles

[gmuloc]

Change Summary

We broke some links, this unbroke the links

Component(s) name

documentation

Proposed changes

• fix the links
• turns mkdocs warnings into errors to prevent this to ever happening agin

How to test

doc builds without warning, anyway now warnings are errors so this is better!\

Checklist

User Checklist

• click the links and marvel

Repository Checklist

• My code has been rebased from devel before I start
• I have read the CONTRIBUTING document.
• My change requires a change to the documentation and documentation have been updated accordingly.
• I have updated molecule CI testing accordingly. (check the box if not applicable)

[github-actions]

Review docs on Read the Docs

To test this pull request:

# Create virtual environment for this testing below the current directory
python -m venv test-avd-pr-4039
# Activate the virtual environment
source test-avd-pr-4039/bin/activate
# Install all requirements including PyAVD
pip install "pyavd[ansible] @ git+https://github.com/gmuloc/avd.git@fix-mkdocs#subdirectory=python-avd" --force
# Install Ansible collection
ansible-galaxy collection install git+https://github.com/gmuloc/avd.git#/ansible_collections/arista/avd/,fix-mkdocs --force
# Optional: Install AVD examples
cd test-avd-pr-4039
ansible-playbook arista.avd.install_examples

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud

[carlbuchmann]

LGTM