Docs Revamp

[cmsirbu]

• Set up mkdocs project and build on RTD
• RTD build installs collection from checked-out branch
• Build plugin docs
• Swap all existing docs to Markdown
• Changelog - minor tweaks so it renders ok in the docs, but it should be revisited and reformatted.

In order for mkdocs to build documentation when running locally for development, the collection must be installed. It is now installed by the invoke docs command every time it is run in the repository subfolder called collections. This ensures it does not clash with any other locally installed collections.

[cmsirbu]

This is ready for review - live build can be seen here: https://docs-landing-page--447.org.readthedocs.build/projects/ansible/en/447/

[joewesch]

Is there anything we can do to render the existing documentation formatting macros (e.g., C() for pre-formatted text and E() for environment variables) that are used for the ansible galaxy docs?

[cmsirbu]

Is there anything we can do to render the existing documentation formatting macros (e.g., C() for pre-formatted text and E() for environment variables) that are used for the ansible galaxy docs?

It probably is doable, I've opened cmsirbu/mkdocs-ansible-collection#10 to track it. Won't have time to dig deep into it until I get through the remaining plugin types first for better coverage.