Documentation Checklist: Ansible 12 release

[samccann]

Release checklist for Ansible 12 documentation. See follow on comment for full list.

[samccann]

Update the documentation and publish the 9 version of Ansible documentation. Tasks include:

Pre-release tasks:

• Stage the release docs on test when beta is available.
• Update the Release Status grid on the Release and Maintenance page in devel to link in changelogs. DO NOT mark Ansible 11 as EOL as it may be an 'LTS' release, and add Ansible 13 as in development.
• backport to stable-2.19 and stable 2.18 (for Ansible 11)
• Verify that the Ansible 12 porting guide has a link to the Ansible 12 changelog file in GitHub.
• Build docs and validate new collections docs after they are added to https://github.com/ansible-community/ansible-build-data
• Verify that release/main page and porting pages are kept in sync between latest and devel
• update conf.py:
  • Set 'latest_version', under html_context as follows:
    '12' if tags.has('ansible')
  • Update version switcher to add Ansible 11 (TBD) so it goes to just devel, 11, and latest
  • Verify core porting guide and roadmaps are listed under ‘exclude_patterns’.
  • Merge to devel on release day only
  • Backport to stable-2.19 , stable-2.18.

In stable-2.19 branch:

• update conf.py VERSION to '12' if tags.has('ansible') or tags.has('all') else'

Update the build and docsite (internal RH tasks):

• Publish 12 on release day. Then immediately:
• Update the 2.9 <--> 12 redirects on the docsite repo by renaming the ansible/11 directory to ansible/12 and republish the docsite.

RTD changes:

• Navigate to Settings and update default branch to 12 at https://app.readthedocs.org/projects/package-doc-builds/
• Click the ... menu next to Version 12 and click Configure Versions . Update settings for the 12 build to unhide it.

Docs build workflow changes:

• Go to build-latest-docs.yml and update to core 2.19 and Ansible 12 in both places.

Post release:

• Update the Build_Ansible_Package_Docs publication jenkins job - Configure and add an option for the next release number to the choices available for PACKAGE_VERSION. (aka add 13). See https://gitlab.cee.redhat.com/aap-ci/aap-jenkins-shared-library/-/merge_requests/1634 (only accessible to Red Hatter).
• update intersphinx links. see add support for Ansible 9 intersphinx links #878
  • backport to stable-2.19 and republish

[samccann]

Separate PR to add #2627 to latest.