Deprecate foreman and katello modules (#42043)

* Deprecate foreman and katello modules in 2.8, remove in 2.12

lib/ansible/modules/remote_management/foreman/_foreman.py

@@ -8,13 +8,17 @@ from __future__ import absolute_import, division, print_function
 __metaclass__ = type
 
 ANSIBLE_METADATA = {'metadata_version': '1.1',
-                    'status': ['preview'],
+                    'status': ['deprecated'],
                     'supported_by': 'community'}
 
 DOCUMENTATION = '''
 ---
 module: foreman
 short_description: Manage Foreman Resources
+deprecated:
+    removed_in: "2.12"
+    why: "Replaced by re-designed individual modules living at https://github.com/theforeman/foreman-ansible-modules"
+    alternative: https://github.com/theforeman/foreman-ansible-modules
 description:
     - Allows the management of Foreman resources inside your Foreman server.
 version_added: "2.3"
@@ -33,6 +37,11 @@ options:
         description:
             - Username on Foreman server.
         required: true
+    verify_ssl:
+        description:
+            - Whether to verify an SSL connection to Foreman server.
+        type: bool
+        default: False
     password:
         description:
             - Password for user accessing Foreman server.

lib/ansible/modules/remote_management/foreman/_katello.py

@@ -8,13 +8,17 @@ from __future__ import absolute_import, division, print_function
 __metaclass__ = type
 
 ANSIBLE_METADATA = {'metadata_version': '1.1',
-                    'status': ['preview'],
+                    'status': ['deprecated'],
                     'supported_by': 'community'}
 
 DOCUMENTATION = '''
 ---
 module: katello
 short_description: Manage Katello Resources
+deprecated:
+    removed_in: "2.12"
+    why: "Replaced by re-designed individual modules living at https://github.com/theforeman/foreman-ansible-modules"
+    alternative: https://github.com/theforeman/foreman-ansible-modules
 description:
     - Allows the management of Katello resources inside your Foreman server.
 version_added: "2.3"