Intersphinx

[samccann]

Fixes #2546

[oraNod]

@felixfontein Hey, just curious about this docs build error that's failing in CI:

docs/docsite/rst/dev_guide/developing_collections_documenting.rst:15:0: undefined-label: undefined label: 'ansible_collections.sensu.sensu_go.install_role'

It comes from this line which uses semantic markup.

Weirdly if I revert my last commit that removes the Ansible 11 intersphinx link, that error goes away. However several new errors seem to arise, which I can also see on devel when running the docs-build check.

docs/docsite/rst/2.10_index.rst:23:0: warning: toctree contains reference to excluded document 'porting_guides/porting_guides'
docs/docsite/rst/2.10_index.rst:48:0: toc-tree-missing-document: toctree contains reference to nonexisting document 'scenario_guides/cloud_guides'
docs/docsite/rst/2.10_index.rst:48:0: toc-tree-missing-document: toctree contains reference to nonexisting document 'scenario_guides/network_guides'
docs/docsite/rst/2.10_index.rst:48:0: toc-tree-missing-document: toctree contains reference to nonexisting document 'scenario_guides/virt_guides'
docs/docsite/rst/2.10_index.rst:57:0: toc-tree-missing-document: toctree contains reference to nonexisting document 'network/getting_started/index'
docs/docsite/rst/2.10_index.rst:57:0: toc-tree-missing-document: toctree contains reference to nonexisting document 'network/user_guide/index'
docs/docsite/rst/2.10_index.rst:57:0: toc-tree-missing-document: toctree contains reference to nonexisting document 'network/dev_guide/index'
docs/docsite/rst/2.10_index.rst:102:0: warning: toctree contains reference to excluded document 'roadmap/index'
docs/docsite/rst/2.10_index.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/community/contributor_license_agreement.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/community/triage_process.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/dev_guide/developing_modules_general_aci.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/user_guide/guide_rolling_upgrade.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/user_guide/intro_getting_started.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/user_guide/playbooks_templating.rst:0:0: not-in-toc-tree: document isn't included in any toctree
docs/docsite/rst/user_guide/quickstart.rst:0:0: not-in-toc-tree: document isn't included in any toctree

[oraNod]

OK, maybe some of that was a me problem. I cleaned house and grabbed a fresh clone and those toc-tree issues went away. Somehow I ended up with a bunch of orphans on my filesystem that were gitignored.

However we still have that docs-build failure if the Ansible 11 intersphinx is removed.

[felixfontein]

sensu.sensu_go was still included in Ansible 11, but removed from Ansible 12. The markup needs to be fixed, it's no longer possible to link to the role since it's not part of Ansible anymore.

Here's a list of potential replacement roles: https://docs.ansible.com/ansible/devel/collections/index_role.html

[oraNod]

sensu.sensu_go was still included in Ansible 11, but removed from Ansible 12. The markup needs to be fixed, it's no longer possible to link to the role since it's not part of Ansible anymore.

Here's a list of potential replacement roles: https://docs.ansible.com/ansible/devel/collections/index_role.html

Thanks very much @felixfontein

[oraNod]

CI light is green and this PR is clean. Thanks again @samccann and @felixfontein

[patchback]

Backport to stable-2.19: 💚 backport PR created

✅ Backport PR branch: patchback/backports/stable-2.19/3118aec42fda4f6907696e083c60be24082ac27d/pr-3089

Backported as #3122

🤖 @patchback
I'm built with octomachinery and
my source is open — https://github.com/sanitizers/patchback-github-app.

[patchback]

Backport to stable-2.20: 💚 backport PR created

✅ Backport PR branch: patchback/backports/stable-2.20/3118aec42fda4f6907696e083c60be24082ac27d/pr-3089

Backported as #3123

🤖 @patchback
I'm built with octomachinery and
my source is open — https://github.com/sanitizers/patchback-github-app.