From 4526fc39f43308ea0480d930f5b54063e2884d0d Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Sun, 14 Aug 2022 20:23:01 +0200 Subject: [PATCH 1/7] Remoce officially unmaintained collections --- removal_from_ansible.rst | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index b1b9a7e..cbd02c6 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -119,8 +119,17 @@ Process Unmaintained collections ======================== -Identifying and removing an unmaintained collection ---------------------------------------------------- +Collections that have been announced deprecated / unmaintained by their maintainers +----------------------------------------------------------------------------------- + +Process +~~~~~~~ + +#. `Announce upcoming removal from the next major Ansible release `_. +#. `Remove collection from the next major Ansible release `_. + +Identifying and removing an unmaintained collection that has not been deprecated by their maintainers +----------------------------------------------------------------------------------------------------- Conditions for removal ~~~~~~~~~~~~~~~~~~~~~~ From 9a582d71e7d7a53342f910d18eb9aaf0544ff667 Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Mon, 4 Mar 2024 17:26:04 +0100 Subject: [PATCH 2/7] Simplify process --- removal_from_ansible.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index fa822b4..0a8ffd8 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -125,8 +125,16 @@ Collections that have been announced deprecated / unmaintained by their maintain Process ~~~~~~~ -#. `Announce upcoming removal from the next major Ansible release `_. -#. `Remove collection from the next major Ansible release `_. +If the latest stable Ansible version is X.something: + +#. Announce upcoming removal in the Ansible changelog (``https://github.com/ansible-community/ansible-build-data/blob/main//changelog.yaml``). +#. Remove from ``ansible.in`` (``https://github.com/ansible-community/ansible-build-data/blob/main//ansible.in``). +#. Remove from ``collection-meta.yaml`` (``https://github.com/ansible-community/ansible-build-data/blob/main//collection-meta.yaml``). +#. Document actual removal for the next Ansible release in the changelog (``https://github.com/ansible-community/ansible-build-data/blob/main//changelog.yaml``). + +See ``__ for an example on how to do this. + +After this has been approved and merged, announce the upcoming removal in The Bullhorn. Identifying and removing an unmaintained collection that has not been deprecated by their maintainers ----------------------------------------------------------------------------------------------------- From 8b5bf644b1962017abb00d084472c4912156b190 Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Tue, 5 Mar 2024 18:35:32 +0100 Subject: [PATCH 3/7] Refer to announcing upcoming removal and removal again --- removal_from_ansible.rst | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index 0a8ffd8..a50e6eb 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -30,7 +30,7 @@ Announcing upcoming removal #. Announce upcoming removal in the Ansible changelog (``https://github.com/ansible-community/ansible-build-data/blob/main//changelog.yaml``). See the following link for an `example on how to add changelog entries to the Ansible changelog `__. -#. Announce upcoming removal in the collection's issue tracker. +#. Announce upcoming removal in the collection's issue tracker if possible. #. Announce upcoming removal in The Bullhorn. .. _remove_collection: @@ -125,16 +125,10 @@ Collections that have been announced deprecated / unmaintained by their maintain Process ~~~~~~~ -If the latest stable Ansible version is X.something: +#. `Announce upcoming removal from the next major Ansible release `_. +#. `Remove collection from the next major Ansible release `_. -#. Announce upcoming removal in the Ansible changelog (``https://github.com/ansible-community/ansible-build-data/blob/main//changelog.yaml``). -#. Remove from ``ansible.in`` (``https://github.com/ansible-community/ansible-build-data/blob/main//ansible.in``). -#. Remove from ``collection-meta.yaml`` (``https://github.com/ansible-community/ansible-build-data/blob/main//collection-meta.yaml``). -#. Document actual removal for the next Ansible release in the changelog (``https://github.com/ansible-community/ansible-build-data/blob/main//changelog.yaml``). - -See ``__ for an example on how to do this. - -After this has been approved and merged, announce the upcoming removal in The Bullhorn. +See ``__ for an example on how to this in just one PR in ``ansible-build-data``. Identifying and removing an unmaintained collection that has not been deprecated by their maintainers ----------------------------------------------------------------------------------------------------- From 4647232538e1e7485266b10b58dabcb2041ee036 Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Fri, 8 Mar 2024 16:35:39 +0100 Subject: [PATCH 4/7] Commit improvement from Andersson007 Co-authored-by: Andrew Klychkov --- removal_from_ansible.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index a50e6eb..ead9cdf 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -128,7 +128,7 @@ Process #. `Announce upcoming removal from the next major Ansible release `_. #. `Remove collection from the next major Ansible release `_. -See ``__ for an example on how to this in just one PR in ``ansible-build-data``. +See `the example pull request `_ in the ``ansible-build-data`` repository to learn how to remove the collection. Identifying and removing an unmaintained collection that has not been deprecated by their maintainers ----------------------------------------------------------------------------------------------------- From 079739f90f3dd9a197f5319191bcf0d7608f561b Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Tue, 12 Mar 2024 16:37:54 +0100 Subject: [PATCH 5/7] Do not remove after feature freeze --- removal_from_ansible.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index ead9cdf..423acc8 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -125,8 +125,11 @@ Collections that have been announced deprecated / unmaintained by their maintain Process ~~~~~~~ -#. `Announce upcoming removal from the next major Ansible release `_. -#. `Remove collection from the next major Ansible release `_. +If the current major release is X and there hasn't been a feature freeze release of the next major version X+1, remove the collection from Y=(X+1).0.0. +If there already has been a feature freeze release of the next major version X+1, remove the collection from Y=(X+2).0.0. + +#. `Announce upcoming removal from the Y Ansible release `_. +#. `Remove collection from the Y Ansible release `_. See `the example pull request `_ in the ``ansible-build-data`` repository to learn how to remove the collection. From 81c1150dc3970d46f23c503e0e9822db804fd36a Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Tue, 12 Mar 2024 19:42:40 +0100 Subject: [PATCH 6/7] Improvements from flowerysong --- removal_from_ansible.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index 423acc8..0157b81 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -119,8 +119,8 @@ Process Unmaintained collections ======================== -Collections that have been announced deprecated / unmaintained by their maintainers ------------------------------------------------------------------------------------ +Removing a collection that has been explicitly deprecated or abandoned by its maintainers +----------------------------------------------------------------------------------------- Process ~~~~~~~ @@ -133,8 +133,8 @@ If there already has been a feature freeze release of the next major version X+1 See `the example pull request `_ in the ``ansible-build-data`` repository to learn how to remove the collection. -Identifying and removing an unmaintained collection that has not been deprecated by their maintainers ------------------------------------------------------------------------------------------------------ +Identifying and removing an unmaintained collection that has not been deprecated by its maintainers +--------------------------------------------------------------------------------------------------- Conditions for removal ~~~~~~~~~~~~~~~~~~~~~~ From d39757d61035186937d28c90e2199106267427fe Mon Sep 17 00:00:00 2001 From: Mario Lenz Date: Wed, 13 Mar 2024 08:09:47 +0100 Subject: [PATCH 7/7] Update: (former) maintainers --- removal_from_ansible.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/removal_from_ansible.rst b/removal_from_ansible.rst index 0157b81..0a1a1c2 100644 --- a/removal_from_ansible.rst +++ b/removal_from_ansible.rst @@ -119,8 +119,8 @@ Process Unmaintained collections ======================== -Removing a collection that has been explicitly deprecated or abandoned by its maintainers ------------------------------------------------------------------------------------------ +Removing a collection that has been explicitly deprecated or abandoned by its (former) maintainers +-------------------------------------------------------------------------------------------------- Process ~~~~~~~