doc fragments workaround for downstream (#59)

* doc fragments workaround for downstream

Signed-off-by: Adam Miller <admiller@redhat.com>

* make shellcheck happy

Signed-off-by: Adam Miller <admiller@redhat.com>

* fix collection location for downstream doc fragment resolution

Signed-off-by: Adam Miller <admiller@redhat.com>

* do things in the correct order

Signed-off-by: Adam Miller <admiller@redhat.com>

* add ANSIBLE_COLLECTIONS_PATH to ansible-doc for downstream

Signed-off-by: Adam Miller <admiller@redhat.com>

* remove elements of the json dump that aren't valid for DOCUMENTATION

Signed-off-by: Adam Miller <admiller@redhat.com>

* Add fix for Ansible 2.9

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>

* Update ci/downstream.sh

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
Co-authored-by: Jeff Geerling <geerlingguy@mac.com>

plugins/modules/k8s.py

@@ -6,15 +6,9 @@
 
 
 from __future__ import absolute_import, division, print_function
-
-
 __metaclass__ = type
 
-
-ANSIBLE_METADATA = {'metadata_version': '1.1',
-                    'status': ['preview'],
-                    'supported_by': 'community'}
-
+# STARTREMOVE (downstream)
 DOCUMENTATION = '''
 
 module: k8s
@@ -112,8 +106,8 @@ options:
         description:
         - The value of the reason field in your desired condition
         - For example, if a C(Deployment) is paused, The C(Progressing) C(type) will have the C(DeploymentPaused) reason.
-        - The possible reasons in a condition are specific to each resource type in Kubernetes. See the API documentation of the status field
-          for a given resource to see possible choices.
+        - The possible reasons in a condition are specific to each resource type in Kubernetes.
+          See the API documentation of the status field for a given resource to see possible choices.
     type: dict
   validate:
     description:
@@ -264,6 +258,7 @@ result:
        type: int
        sample: 48
 '''
+# ENDREMOVE (downstream)
 
 import re
 import operator
@@ -396,7 +391,9 @@ class OKDRawModule(KubernetesRawModule):
                         image = existing['spec']['template']['spec']['containers'][old_container_index]['image']
                         definition['spec']['template']['spec']['containers'][new_container_index]['image'] = image
 
-                    existing_index = self.get_index(trigger['imageChangeParams'], [x.get('imageChangeParams') for x in existing_triggers], ['containerNames'])
+                    existing_index = self.get_index(trigger['imageChangeParams'],
+                                                    [x.get('imageChangeParams') for x in existing_triggers],
+                                                    ['containerNames'])
                     if existing_index is not None:
                         existing_image = existing_triggers[existing_index].get('imageChangeParams', {}).get('lastTriggeredImage')
                         if existing_image:

plugins/modules/openshift_auth.py

@@ -5,10 +5,8 @@
 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
 
 from __future__ import absolute_import, division, print_function
-
 __metaclass__ = type
 
-
 DOCUMENTATION = r'''
 
 module: openshift_auth

plugins/modules/openshift_process.py

@@ -5,10 +5,9 @@
 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
 
 from __future__ import absolute_import, division, print_function
-
 __metaclass__ = type
 
-
+# STARTREMOVE (downstream)
 DOCUMENTATION = r'''
 module: openshift_process
 
@@ -40,7 +39,7 @@ options:
       - The name of the Template to process.
       - The Template must be present in the cluster.
       - When provided, I(namespace) is required.
-      - Mutually exlusive with I(resource_definition) or I(src)
+      - Mutually exclusive with I(resource_definition) or I(src)
     type: str
   namespace:
     description:
@@ -202,6 +201,7 @@ resources:
              type: complex
              description: Array of status conditions for the object. Not guaranteed to be present
 '''
+# ENDREMOVE (downstream)
 
 import re
 import os

plugins/modules/openshift_route.py

@@ -8,7 +8,7 @@ from __future__ import absolute_import, division, print_function
 
 __metaclass__ = type
 
-
+# STARTREMOVE (downstream)
 DOCUMENTATION = r'''
 module: openshift_route
 
@@ -296,6 +296,7 @@ duration:
   type: int
   sample: 48
 '''
+# ENDREMOVE (downstream)
 
 import copy
 import traceback