Documentation Checklist: ansible-core 2.17

[samccann]

Documentation checklist to prepare for and deliver the ansible-core 2.17 release. See follow-on comment for the full checklist.

[samccann]

Tasks include:

• Review ansible-core porting guide to ensure the 2.17 porting guide is added to the index and ensure it links to core 2.17 changelogs.

• include 2.17 in the ansible-core support matrix and ensure maintenance/eol releases listed accurately. Include links to changelogs.

• Verify or update the Powershell range for 2.17.

• Merge, then Backport any PRs for the above items to stable-2.17 branch.

• In stable-2.17 branch - Update ansible-core branch indicator file in docs/ansible-core-branch.txt in the stable-2.17 branch from devel to stable-2.17. See [stable-2.16] Update ansible-core branch indicator file #424

• Publish 2.17 docs to test after 2.17 beta! 4/8/2024

• Update conf.py (DO NOT MERGE UNTIL RELEASE DAY)

  • Set '2.17' if tags.has('core_lang') or tags.has('core') else, under 'html_context' 'latest_version'
  • Set ('2.17', '2.16', '2.15', 'devel',) if tags.has('core') else, under ‘html_context’ 'available_versions'
  • Verify Ansible package porting guide and roadmaps are listed under ‘exclude_patterns’.
    stable-2.17 branch:

• In stable-2.17 branch - change VERSION (capitalized) from devel to 2.17 as follows:
  '2.17' if tags.has('core_lang') or tags.has('core') else

On release day:

• Merge conf.py PR to devel
• Backport to stable-2.17, stable-2.16, and stable-2.15
• publish to all three releases to prod

Post release:

• Update the backport instructions to target the new “latest” branch, see update backport instructions to match 2.16 #799
• Make sure all server-side redirects are updated as necessary - see Adds docs redirects for PR 54554 docsite#11
• End-of-life the 2.14 docs
  • update the release/maintenance table to add EOL label to 2.14 row.
  • In the EOL branch (stable-2.14), update page banner to EOL to the release no longer supported. See eol 2.12 docs ansible#80957

[samccann]

core-2.17 published to test - http://docs.testing.ansible.com/ansible-core/2.17/

NOTE: Version switcher etc will not work until release day.