[Epic] Open up the Ansible package docs publishing outside of RH

[samccann]

Today we're tied to Red Hat being the only people who can publish Ansible package and core documentation to the test site or docs.ansible.com.

This issue tracks the work to open this up to community docs mantainers.

[Spredzy]

@oraNod with the move to RTD does that ticket still stand ?

[samccann]

So far, the package docs are not on RTD because (I think) they are a beast to build.

[oraNod]

Yep. We still need to get the package docs to build on RTD or somewhere. I think with the nox tooling we added in the past year we can do it by breaking the build into stages. Hopefully the work to update Sphinx versions will help us move faster and pick up performance improvements.

[samccann]

Something we'll need to keep in mind. We currently have redirects between the old 2.9 module pages and the new collection module pages here. This supports the ability for the version switcher to go between latest/devel and 2.9 (or someone hacking the url to go from 2.9 to latest since there is no version switcher anymore on the EOL 2.9).

As part of this, we discovered that any publishing of the Ansible package docs would blow away those redirect folders and we had to tie the docs jenkins build to the docsite jenkins build (to republish the docsite and those redirects whenever we publish the package docs).

NOTE: The jenkins job for the core docs also triggers the docsite jenkins job but may not need to since these redirects don't work on the core docsite anyway (there is no 'core' 2.9).