Core 2.21 stuff (#3137)

Co-authored-by: Sandra McCann <samccann@redhat.com>

Author: sivel

docs/docsite/rst/porting_guides/core_porting_guides.rst

@@ -12,6 +12,7 @@ Please note that this is not a complete list. If you believe any extra informati
    :maxdepth: 1
    :glob:
 
+   porting_guide_core_2.21
    porting_guide_core_2.20
    porting_guide_core_2.19
    porting_guide_core_2.18

docs/docsite/rst/porting_guides/porting_guide_core_2.21.rst

@@ -0,0 +1,100 @@
+
+.. _porting_2.21_guide_core:
+
+*******************************
+Ansible-core 2.21 Porting Guide
+*******************************
+
+This section discusses the behavioral changes between ``ansible-core`` 2.20 and ``ansible-core`` 2.21.
+
+It is intended to assist in updating your playbooks, plugins,
+and other parts of your Ansible infrastructure so they will work with this version of Ansible.
+
+Review this page and the
+`ansible-core Changelog for 2.21 <https://github.com/ansible/ansible/blob/stable-2.21/changelogs/CHANGELOG-v2.21.rst>`_
+to understand necessary changes.
+
+This document is part of a collection on porting.
+The complete list of porting guides can be found at :ref:`porting guides <porting_guides>`.
+
+.. contents:: Topics
+
+.. _2.21_introduction:
+
+Introduction
+============
+
+No notable changes
+
+.. _2.21_playbook:
+
+Playbook
+========
+
+No notable changes
+
+.. _2.21_engine:
+
+Engine
+======
+
+No notable changes
+
+.. _2.21_plugin_api:
+
+Plugin API
+==========
+
+.. _2.21_command_line:
+
+Command Line
+============
+
+No notable changes
+
+.. _2.21_deprecated:
+
+Deprecated
+==========
+
+No notable changes
+
+.. _2.21_modules:
+
+Modules
+=======
+
+Modules removed
+---------------
+
+The following modules no longer exist:
+
+* No notable changes
+
+Deprecation notices
+-------------------
+
+No notable changes
+
+Noteworthy module changes
+-------------------------
+
+No notable changes
+
+Plugins
+=======
+
+Noteworthy plugin changes
+-------------------------
+
+No notable changes
+
+Porting custom scripts
+======================
+
+No notable changes
+
+Networking
+==========
+
+No notable changes

docs/docsite/rst/reference_appendices/release_and_maintenance.rst

@@ -168,6 +168,14 @@ Dates listed indicate the start date of the maintenance cycle.
      - End Of Life
      - Control Node Python
      - Target Python / PowerShell
+   * - `2.21`_
+     - | GA: May 2026
+       | Critical: Nov 2026
+       | Security: May 2027
+     - Nov 2027
+     - | Python 3.12 - 3.14
+     - | Python 3.9 - 3.14
+       | PowerShell 5.1 - 7
    * - `2.20`_
      - | GA: 03 Nov 2025
        | Critical: 18 May 2026
@@ -283,14 +291,6 @@ Dates listed indicate the start date of the maintenance cycle.
      - | Python 2.6 - 2.7
        | Python 3.5 - 3.8
        | PowerShell 3 - 5.1
-..    * - 2.21
-..      - May 2026
-..      - Nov 2026
-..      - May 2027
-..      - Nov 2027
-..      - | Python 3.12 - 3.14
-..      - | Python 3.9 - 3.14
-..        | PowerShell 5.1
 ..    * - 2.22
 ..      - Nov 2026
 ..      - May 2027
@@ -337,6 +337,7 @@ Dates listed indicate the start date of the maintenance cycle.
 .. _2.18: https://github.com/ansible/ansible/blob/stable-2.18/changelogs/CHANGELOG-v2.18.rst
 .. _2.19: https://github.com/ansible/ansible/blob/stable-2.19/changelogs/CHANGELOG-v2.19.rst
 .. _2.20: https://github.com/ansible/ansible/blob/stable-2.20/changelogs/CHANGELOG-v2.20.rst
+.. _2.21: https://github.com/ansible/ansible/blob/stable-2.21/changelogs/CHANGELOG-v2.21.rst
 
 .. _ansible_core_versioning:
 

docs/docsite/rst/roadmap/ROADMAP_2_21.rst

@@ -0,0 +1,60 @@
+.. _core_roadmap_2.21:
+
+*****************
+Ansible-core 2.21
+*****************
+
+.. contents::
+   :local:
+
+Release Schedule
+================
+
+Expected
+--------
+
+PRs must be raised sufficiently in advance of the following dates to have a chance of inclusion in this ansible-core release.
+
+.. note:: Dates are subject to change.
+
+Development Phase
+^^^^^^^^^^^^^^^^^
+
+The ``milestone`` branch will be advanced at the start date of each development phase and the beta 1 release.
+
+- 2025-10-13 Development Phase 1
+- 2025-11-10 Development Phase 2
+- 2025-12-08 Development Phase 3
+- 2026-01-05 Development Phase 4
+- 2026-02-02 Development Phase 5
+- 2026-03-02 Development Phase 6
+
+Release Phase
+^^^^^^^^^^^^^
+
+- 2026-03-30 Feature Freeze
+
+- 2026-04-06 Beta 1
+
+- 2026-04-27 Release Candidate 1
+
+- 2026-05-18 Release
+
+.. note:: The beta and release candidate schedules allow for up to 3 releases on a weekly schedule depending on the necessity of creating a release.
+
+Release Manager
+===============
+
+Ansible Core Team
+
+Planned work
+============
+
+* TBD
+
+Delayed work
+============
+
+The following work has been delayed and retargeted for a future release:
+
+* TBD

docs/docsite/rst/roadmap/ansible_core_roadmap_index.rst

@@ -18,6 +18,7 @@ You can submit feedback on the current roadmap by creating a topic on the :ref:`
    :glob:
    :caption: ansible-core Roadmaps
 
+   ROADMAP_2_21
    ROADMAP_2_20
    ROADMAP_2_19
    ROADMAP_2_18