Doc: Move docs folder to root of repo

[carlbuchmann]

Change Summary

Move docs folder to root of repo and update relative path links to included content

Component(s) name

AVD documentation website

Proposed changes

How to test

• Moved ./ansible_collections/arista/avd/docs to ./docs
• Moved ./ansible_collections/arista/avd/media/* to ./docs/_media/*
• Updated all relative path links
• updated mkdocs configuration
  • added same-dir plugin requirement
  • excluded folders:
    - development/*
    - galaxy-importer/*
    - python-avd/*
• updated old avd.sh links to avd.arista.com
• Updated pre-commit hooks for ansible plugins documentation

Todo after we merge this PR

• Update avd-docs and read the docs to point to new requirements file:
  • ./avd/docs/requirements.txt
• Once confirmed we will submit a PR to delete:
  • /avd/ansible_collections/arista/avd/docs/requirements.txt

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-4923
# Activate the virtual environment
source test-avd-pr-4923/bin/activate
# Install all requirements including PyAVD
pip install "pyavd[ansible] @ git+https://github.com/carlbuchmann/avd.git@relocate-docs#subdirectory=python-avd" --force
# Point Ansible collections path to the Python virtual environment
export ANSIBLE_COLLECTIONS_PATH=$VIRTUAL_ENV/ansible_collections
# Install Ansible collection
ansible-galaxy collection install git+https://github.com/carlbuchmann/avd.git#/ansible_collections/arista/avd/,relocate-docs --force
# Optional: Install AVD examples
cd test-avd-pr-4923
ansible-playbook arista.avd.install_examples

[joelbreton2]

LGTM

[gmuloc]

inspection of the changes look good to me

we will make this better down the line :)