aix_*: deprecation (#11540)

* aix_*: deprecation

* add changelog frag

* update chglog

* adjustments from review

* typo

* wordsmithing from review

Author: russoz

changelogs/fragments/11540-deprecate-aix.yml

@@ -0,0 +1,6 @@
+deprecated_features:
+  - aix_devices - module is superseded by equivalent in ``ibm.power_aix`` collection. It will be removed from community.general 15.0.0 (https://github.com/ansible-collections/community.general/issues/11290, https://github.com/ansible-collections/community.general/pull/11540).
+  - aix_filesystem - module is superseded by equivalent in ``ibm.power_aix`` collection. It will be removed from community.general 15.0.0 (https://github.com/ansible-collections/community.general/issues/11290, https://github.com/ansible-collections/community.general/pull/11540).
+  - aix_inittab - module is superseded by equivalent in ``ibm.power_aix`` collection. It will be removed from community.general 15.0.0 (https://github.com/ansible-collections/community.general/issues/11290, https://github.com/ansible-collections/community.general/pull/11540).
+  - aix_lvg - module is superseded by equivalent in ``ibm.power_aix`` collection. It will be removed from community.general 15.0.0 (https://github.com/ansible-collections/community.general/issues/11290, https://github.com/ansible-collections/community.general/pull/11540).
+  - aix_lvol - module is superseded by equivalent in ``ibm.power_aix`` collection. It will be removed from community.general 15.0.0 (https://github.com/ansible-collections/community.general/issues/11290, https://github.com/ansible-collections/community.general/pull/11540).

meta/runtime.yml

@@ -375,6 +375,26 @@ plugin_routing:
       tombstone:
         removal_version: 3.0.0
         warning_text: Use community.general.hpilo_info instead.
+    aix_devices:
+      deprecation:
+        removal_version: 15.0.0
+        warning_text: Use ibm.power_aix.devices instead. The C(ibm.power_aix) collection is actively maintained by IBM.
+    aix_filesystem:
+      deprecation:
+        removal_version: 15.0.0
+        warning_text: Use ibm.power_aix.filesystem instead. The C(ibm.power_aix) collection is actively maintained by IBM.
+    aix_inittab:
+      deprecation:
+        removal_version: 15.0.0
+        warning_text: Use ibm.power_aix.inittab instead. The C(ibm.power_aix) collection is actively maintained by IBM.
+    aix_lvg:
+      deprecation:
+        removal_version: 15.0.0
+        warning_text: Use ibm.power_aix.lvg instead. The C(ibm.power_aix) collection is actively maintained by IBM.
+    aix_lvol:
+      deprecation:
+        removal_version: 15.0.0
+        warning_text: Use ibm.power_aix.lvol instead. The C(ibm.power_aix) collection is actively maintained by IBM.
     idrac_firmware:
       redirect: dellemc.openmanage.idrac_firmware
     idrac_redfish_facts:

plugins/modules/aix_devices.py

@@ -13,6 +13,12 @@
 short_description: Manages AIX devices
 description:
   - This module discovers, defines, removes and modifies attributes of AIX devices.
+deprecated:
+  removed_in: 15.0.0
+  why: The module is not actively maintained.
+  alternative: >-
+    Use C(ibm.power_aix.devices) instead.
+    See U(https://ibm.github.io/ansible-power-aix/modules/devices.html) for details.
 extends_documentation_fragment:
   - community.general.attributes
 attributes:

plugins/modules/aix_filesystem.py

@@ -14,6 +14,12 @@
 description:
   - This module creates, removes, mount and unmount LVM and NFS file system for AIX using C(/etc/filesystems).
   - For LVM file systems is possible to resize a file system.
+deprecated:
+  removed_in: 15.0.0
+  why: The module is not actively maintained.
+  alternative: >-
+    Use C(ibm.power_aix.filesystem) instead.
+    See U(https://ibm.github.io/ansible-power-aix/modules/filesystem.html) for details.
 extends_documentation_fragment:
   - community.general.attributes
 attributes:

plugins/modules/aix_inittab.py

@@ -13,6 +13,12 @@
 short_description: Manages the C(inittab) on AIX
 description:
   - Manages the C(inittab) on AIX.
+deprecated:
+  removed_in: 15.0.0
+  why: The module is not actively maintained.
+  alternative: >-
+    Use C(ibm.power_aix.inittab) instead.
+    See U(https://ibm.github.io/ansible-power-aix/modules/inittab.html) for details.
 extends_documentation_fragment:
   - community.general.attributes
 attributes:

plugins/modules/aix_lvg.py

@@ -13,6 +13,12 @@
 short_description: Manage LVM volume groups on AIX
 description:
   - This module creates, removes or resize volume groups on AIX LVM.
+deprecated:
+  removed_in: 15.0.0
+  why: The module is not actively maintained.
+  alternative: >-
+    Use C(ibm.power_aix.lvg) instead.
+    See U(https://ibm.github.io/ansible-power-aix/modules/lvg.html) for details.
 extends_documentation_fragment:
   - community.general.attributes
 attributes:

plugins/modules/aix_lvol.py

@@ -13,6 +13,12 @@
 short_description: Configure AIX LVM logical volumes
 description:
   - This module creates, removes or resizes AIX logical volumes. Inspired by M(community.general.lvol) module.
+deprecated:
+  removed_in: 15.0.0
+  why: The module is not actively maintained.
+  alternative: >-
+    Use C(ibm.power_aix.lvol) instead.
+    See U(https://ibm.github.io/ansible-power-aix/modules/lvol.html) for details.
 extends_documentation_fragment:
   - community.general.attributes
 attributes: