prompt: We are currently solving the following issue within our repository. Here is the issue text:
  --- BEGIN ISSUE ---
  doc error with inventory plugin for latest awx.awx inventory plugin 
  ### Please confirm the following
  
  - [X] I agree to follow this project's [code of conduct](http://docs.ansible.com/ansible/latest/community/code_of_conduct.html).
  - [X] I have checked the [current issues](https://github.com/ansible/awx/issues) for duplicates.
  - [X] I understand that AWX is open source software provided for free and that I am not entitled to status updates or other assurances.
  
  ### Summary
  
  The documentation for the inventory plugin, awx.awx.controller, was malformed.
  
  rendered webpage for docs is here: https://docs.ansible.com/ansible/latest/collections/awx/awx/controller_inventory.html#ansible-collections-awx-awx-controller-inventory
  
  ### AWX version
  
  N/A
  
  ### Installation method
  
  openshift
  
  ### Modifications
  
  no
  
  ### Ansible version
  
  n/a
  
  ### Operating system
  
  n/a
  
  ### Web browser
  
  Chrome
  
  ### Steps to reproduce
  
  go to https://docs.ansible.com/ansible/latest/collections/awx/awx/controller_inventory.html#ansible-collections-awx-awx-controller-inventory
  
  there is docs errors on the webpage 
  
  >The documentation for the inventory plugin, awx.awx.controller, was malformed.
  
  
  
  ### Expected results
  
  no errors
  
  ### Actual results
  
  ![image](https://user-images.githubusercontent.com/6537680/127372510-15ad611c-3428-42ba-b719-c3b1468dbf27.png)
  
  
  ### Additional information
  
  fast track this to infamous Chris Meyers
  
  --- END ISSUE ---
  
  Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
  --- BEGIN FILES ---
  Path: `awx_collection/plugins/doc_fragments/auth_plugin.py`
  Content:
  ```
  1 # -*- coding: utf-8 -*-
  2 
  3 # Copyright: (c) 2020, Ansible by Red Hat, Inc
  4 # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
  5 
  6 from __future__ import absolute_import, division, print_function
  7 
  8 __metaclass__ = type
  9 
  10 
  11 class ModuleDocFragment(object):
  12 
  13     # Automation Platform Controller documentation fragment
  14     DOCUMENTATION = r'''
  15 options:
  16   host:
  17     description: The network address of your Automation Platform Controller host.
  18     env:
  19     - name: CONTROLLER_HOST
  20     - name: TOWER_HOST
  21     deprecated:
  22     - removed_from_collection: 'awx.awx.controller'
  23     - removed_in: '4.0.0'
  24     - why: Collection name change
  25     - alternative: 'CONTROLLER_HOST'
  26   username:
  27     description: The user that you plan to use to access inventories on the controller.
  28     env:
  29     - name: CONTROLLER_USERNAME
  30     - name: TOWER_USERNAME
  31     deprecated:
  32     - removed_from_collection: 'awx.awx.controller'
  33     - removed_in: '4.0.0'
  34     - why: Collection name change
  35     - alternative: 'CONTROLLER_USERNAME'
  36   password:
  37     description: The password for your controller user.
  38     env:
  39     - name: CONTROLLER_PASSWORD
  40     - name: TOWER_PASSWORD
  41     deprecated:
  42     - removed_from_collection: 'awx.awx.controller'
  43     - removed_in: '4.0.0'
  44     - why: Collection name change
  45     - alternative: 'CONTROLLER_PASSWORD'
  46   oauth_token:
  47     description:
  48     - The OAuth token to use.
  49     env:
  50     - name: CONTROLLER_OAUTH_TOKEN
  51     - name: TOWER_OAUTH_TOKEN
  52     deprecated:
  53     - removed_from_collection: 'awx.awx.controller'
  54     - removed_in: '4.0.0'
  55     - why: Collection name change
  56     - alternative: 'CONTROLLER_OAUTH_TOKEN'
  57   verify_ssl:
  58     description:
  59     - Specify whether Ansible should verify the SSL certificate of the controller host.
  60     - Defaults to True, but this is handled by the shared module_utils code
  61     type: bool
  62     env:
  63     - name: CONTROLLER_VERIFY_SSL
  64     - name: TOWER_VERIFY_SSL
  65     deprecated:
  66     - removed_from_collection: 'awx.awx.controller'
  67     - removed_in: '4.0.0'
  68     - why: Collection name change
  69     - alternative: 'CONTROLLER_VERIFY_SSL'
  70     aliases: [ validate_certs ]
  71 
  72 notes:
  73 - If no I(config_file) is provided we will attempt to use the tower-cli library
  74   defaults to find your host information.
  75 - I(config_file) should be in the following format
  76     host=hostname
  77     username=username
  78     password=password
  79 '''
  80
  ```
  --- END FILES ---
  
  Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.
  
  Here is an example:
  
  ```diff
  diff --git a/examples/server_async.py b/examples/server_async.py
  --- a/examples/server_async.py
  +++ b/examples/server_async.py
  @@ -313,4 +313,4 @@
   
   
   if __name__ == "__main__":
  -    asyncio.run(run_async_server("."), debug=True)
  +    asyncio.run(run_async_server(), debug=True)
  diff --git a/examples/server_sync.py b/examples/server_sync.py
  --- a/examples/server_sync.py
  +++ b/examples/server_sync.py
  @@ -313,5 +313,5 @@
   
   
   if __name__ == "__main__":
  -    server = run_sync_server(".")
  +    server = run_sync_server()
       server.shutdown()
  
  ```
  
golden_diff: diff --git a/awx_collection/plugins/doc_fragments/auth_plugin.py b/awx_collection/plugins/doc_fragments/auth_plugin.py
  --- a/awx_collection/plugins/doc_fragments/auth_plugin.py
  +++ b/awx_collection/plugins/doc_fragments/auth_plugin.py
  @@ -18,42 +18,42 @@
       env:
       - name: CONTROLLER_HOST
       - name: TOWER_HOST
  -    deprecated:
  -    - removed_from_collection: 'awx.awx.controller'
  -    - removed_in: '4.0.0'
  -    - why: Collection name change
  -    - alternative: 'CONTROLLER_HOST'
  +      deprecated:
  +        collection_name: 'awx.awx'
  +        version: '4.0.0'
  +        why: Collection name change
  +        alternatives: 'CONTROLLER_HOST'
     username:
       description: The user that you plan to use to access inventories on the controller.
       env:
       - name: CONTROLLER_USERNAME
       - name: TOWER_USERNAME
  -    deprecated:
  -    - removed_from_collection: 'awx.awx.controller'
  -    - removed_in: '4.0.0'
  -    - why: Collection name change
  -    - alternative: 'CONTROLLER_USERNAME'
  +      deprecated:
  +        collection_name: 'awx.awx'
  +        version: '4.0.0'
  +        why: Collection name change
  +        alternatives: 'CONTROLLER_USERNAME'
     password:
       description: The password for your controller user.
       env:
       - name: CONTROLLER_PASSWORD
       - name: TOWER_PASSWORD
  -    deprecated:
  -    - removed_from_collection: 'awx.awx.controller'
  -    - removed_in: '4.0.0'
  -    - why: Collection name change
  -    - alternative: 'CONTROLLER_PASSWORD'
  +      deprecated:
  +        collection_name: 'awx.awx'
  +        version: '4.0.0'
  +        why: Collection name change
  +        alternatives: 'CONTROLLER_PASSWORD'
     oauth_token:
       description:
       - The OAuth token to use.
       env:
       - name: CONTROLLER_OAUTH_TOKEN
       - name: TOWER_OAUTH_TOKEN
  -    deprecated:
  -    - removed_from_collection: 'awx.awx.controller'
  -    - removed_in: '4.0.0'
  -    - why: Collection name change
  -    - alternative: 'CONTROLLER_OAUTH_TOKEN'
  +      deprecated:
  +        collection_name: 'awx.awx'
  +        version: '4.0.0'
  +        why: Collection name change
  +        alternatives: 'CONTROLLER_OAUTH_TOKEN'
     verify_ssl:
       description:
       - Specify whether Ansible should verify the SSL certificate of the controller host.
  @@ -62,11 +62,11 @@
       env:
       - name: CONTROLLER_VERIFY_SSL
       - name: TOWER_VERIFY_SSL
  -    deprecated:
  -    - removed_from_collection: 'awx.awx.controller'
  -    - removed_in: '4.0.0'
  -    - why: Collection name change
  -    - alternative: 'CONTROLLER_VERIFY_SSL'
  +      deprecated:
  +        collection_name: 'awx.awx'
  +        version: '4.0.0'
  +        why: Collection name change
  +        alternatives: 'CONTROLLER_VERIFY_SSL'
       aliases: [ validate_certs ]
   
   notes:
  
verification_info: {"golden_diff": "diff --git a/awx_collection/plugins/doc_fragments/auth_plugin.py b/awx_collection/plugins/doc_fragments/auth_plugin.py\n--- a/awx_collection/plugins/doc_fragments/auth_plugin.py\n+++ b/awx_collection/plugins/doc_fragments/auth_plugin.py\n@@ -18,42 +18,42 @@\n     env:\n     - name: CONTROLLER_HOST\n     - name: TOWER_HOST\n-    deprecated:\n-    - removed_from_collection: 'awx.awx.controller'\n-    - removed_in: '4.0.0'\n-    - why: Collection name change\n-    - alternative: 'CONTROLLER_HOST'\n+      deprecated:\n+        collection_name: 'awx.awx'\n+        version: '4.0.0'\n+        why: Collection name change\n+        alternatives: 'CONTROLLER_HOST'\n   username:\n     description: The user that you plan to use to access inventories on the controller.\n     env:\n     - name: CONTROLLER_USERNAME\n     - name: TOWER_USERNAME\n-    deprecated:\n-    - removed_from_collection: 'awx.awx.controller'\n-    - removed_in: '4.0.0'\n-    - why: Collection name change\n-    - alternative: 'CONTROLLER_USERNAME'\n+      deprecated:\n+        collection_name: 'awx.awx'\n+        version: '4.0.0'\n+        why: Collection name change\n+        alternatives: 'CONTROLLER_USERNAME'\n   password:\n     description: The password for your controller user.\n     env:\n     - name: CONTROLLER_PASSWORD\n     - name: TOWER_PASSWORD\n-    deprecated:\n-    - removed_from_collection: 'awx.awx.controller'\n-    - removed_in: '4.0.0'\n-    - why: Collection name change\n-    - alternative: 'CONTROLLER_PASSWORD'\n+      deprecated:\n+        collection_name: 'awx.awx'\n+        version: '4.0.0'\n+        why: Collection name change\n+        alternatives: 'CONTROLLER_PASSWORD'\n   oauth_token:\n     description:\n     - The OAuth token to use.\n     env:\n     - name: CONTROLLER_OAUTH_TOKEN\n     - name: TOWER_OAUTH_TOKEN\n-    deprecated:\n-    - removed_from_collection: 'awx.awx.controller'\n-    - removed_in: '4.0.0'\n-    - why: Collection name change\n-    - alternative: 'CONTROLLER_OAUTH_TOKEN'\n+      deprecated:\n+        collection_name: 'awx.awx'\n+        version: '4.0.0'\n+        why: Collection name change\n+        alternatives: 'CONTROLLER_OAUTH_TOKEN'\n   verify_ssl:\n     description:\n     - Specify whether Ansible should verify the SSL certificate of the controller host.\n@@ -62,11 +62,11 @@\n     env:\n     - name: CONTROLLER_VERIFY_SSL\n     - name: TOWER_VERIFY_SSL\n-    deprecated:\n-    - removed_from_collection: 'awx.awx.controller'\n-    - removed_in: '4.0.0'\n-    - why: Collection name change\n-    - alternative: 'CONTROLLER_VERIFY_SSL'\n+      deprecated:\n+        collection_name: 'awx.awx'\n+        version: '4.0.0'\n+        why: Collection name change\n+        alternatives: 'CONTROLLER_VERIFY_SSL'\n     aliases: [ validate_certs ]\n \n notes:\n", "issue": "doc error with inventory plugin for latest awx.awx inventory plugin \n### Please confirm the following\n\n- [X] I agree to follow this project's [code of conduct](http://docs.ansible.com/ansible/latest/community/code_of_conduct.html).\n- [X] I have checked the [current issues](https://github.com/ansible/awx/issues) for duplicates.\n- [X] I understand that AWX is open source software provided for free and that I am not entitled to status updates or other assurances.\n\n### Summary\n\nThe documentation for the inventory plugin, awx.awx.controller, was malformed.\r\n\r\nrendered webpage for docs is here: https://docs.ansible.com/ansible/latest/collections/awx/awx/controller_inventory.html#ansible-collections-awx-awx-controller-inventory\n\n### AWX version\n\nN/A\n\n### Installation method\n\nopenshift\n\n### Modifications\n\nno\n\n### Ansible version\n\nn/a\n\n### Operating system\n\nn/a\n\n### Web browser\n\nChrome\n\n### Steps to reproduce\n\ngo to https://docs.ansible.com/ansible/latest/collections/awx/awx/controller_inventory.html#ansible-collections-awx-awx-controller-inventory\r\n\r\nthere is docs errors on the webpage \r\n\r\n>The documentation for the inventory plugin, awx.awx.controller, was malformed.\r\n\r\n\n\n### Expected results\n\nno errors\n\n### Actual results\n\n![image](https://user-images.githubusercontent.com/6537680/127372510-15ad611c-3428-42ba-b719-c3b1468dbf27.png)\r\n\n\n### Additional information\n\nfast track this to infamous Chris Meyers\n", "before_files": [{"content": "# -*- coding: utf-8 -*-\n\n# Copyright: (c) 2020, Ansible by Red Hat, Inc\n# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)\n\nfrom __future__ import absolute_import, division, print_function\n\n__metaclass__ = type\n\n\nclass ModuleDocFragment(object):\n\n    # Automation Platform Controller documentation fragment\n    DOCUMENTATION = r'''\noptions:\n  host:\n    description: The network address of your Automation Platform Controller host.\n    env:\n    - name: CONTROLLER_HOST\n    - name: TOWER_HOST\n    deprecated:\n    - removed_from_collection: 'awx.awx.controller'\n    - removed_in: '4.0.0'\n    - why: Collection name change\n    - alternative: 'CONTROLLER_HOST'\n  username:\n    description: The user that you plan to use to access inventories on the controller.\n    env:\n    - name: CONTROLLER_USERNAME\n    - name: TOWER_USERNAME\n    deprecated:\n    - removed_from_collection: 'awx.awx.controller'\n    - removed_in: '4.0.0'\n    - why: Collection name change\n    - alternative: 'CONTROLLER_USERNAME'\n  password:\n    description: The password for your controller user.\n    env:\n    - name: CONTROLLER_PASSWORD\n    - name: TOWER_PASSWORD\n    deprecated:\n    - removed_from_collection: 'awx.awx.controller'\n    - removed_in: '4.0.0'\n    - why: Collection name change\n    - alternative: 'CONTROLLER_PASSWORD'\n  oauth_token:\n    description:\n    - The OAuth token to use.\n    env:\n    - name: CONTROLLER_OAUTH_TOKEN\n    - name: TOWER_OAUTH_TOKEN\n    deprecated:\n    - removed_from_collection: 'awx.awx.controller'\n    - removed_in: '4.0.0'\n    - why: Collection name change\n    - alternative: 'CONTROLLER_OAUTH_TOKEN'\n  verify_ssl:\n    description:\n    - Specify whether Ansible should verify the SSL certificate of the controller host.\n    - Defaults to True, but this is handled by the shared module_utils code\n    type: bool\n    env:\n    - name: CONTROLLER_VERIFY_SSL\n    - name: TOWER_VERIFY_SSL\n    deprecated:\n    - removed_from_collection: 'awx.awx.controller'\n    - removed_in: '4.0.0'\n    - why: Collection name change\n    - alternative: 'CONTROLLER_VERIFY_SSL'\n    aliases: [ validate_certs ]\n\nnotes:\n- If no I(config_file) is provided we will attempt to use the tower-cli library\n  defaults to find your host information.\n- I(config_file) should be in the following format\n    host=hostname\n    username=username\n    password=password\n'''\n", "path": "awx_collection/plugins/doc_fragments/auth_plugin.py"}], "after_files": [{"content": "# -*- coding: utf-8 -*-\n\n# Copyright: (c) 2020, Ansible by Red Hat, Inc\n# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)\n\nfrom __future__ import absolute_import, division, print_function\n\n__metaclass__ = type\n\n\nclass ModuleDocFragment(object):\n\n    # Automation Platform Controller documentation fragment\n    DOCUMENTATION = r'''\noptions:\n  host:\n    description: The network address of your Automation Platform Controller host.\n    env:\n    - name: CONTROLLER_HOST\n    - name: TOWER_HOST\n      deprecated:\n        collection_name: 'awx.awx'\n        version: '4.0.0'\n        why: Collection name change\n        alternatives: 'CONTROLLER_HOST'\n  username:\n    description: The user that you plan to use to access inventories on the controller.\n    env:\n    - name: CONTROLLER_USERNAME\n    - name: TOWER_USERNAME\n      deprecated:\n        collection_name: 'awx.awx'\n        version: '4.0.0'\n        why: Collection name change\n        alternatives: 'CONTROLLER_USERNAME'\n  password:\n    description: The password for your controller user.\n    env:\n    - name: CONTROLLER_PASSWORD\n    - name: TOWER_PASSWORD\n      deprecated:\n        collection_name: 'awx.awx'\n        version: '4.0.0'\n        why: Collection name change\n        alternatives: 'CONTROLLER_PASSWORD'\n  oauth_token:\n    description:\n    - The OAuth token to use.\n    env:\n    - name: CONTROLLER_OAUTH_TOKEN\n    - name: TOWER_OAUTH_TOKEN\n      deprecated:\n        collection_name: 'awx.awx'\n        version: '4.0.0'\n        why: Collection name change\n        alternatives: 'CONTROLLER_OAUTH_TOKEN'\n  verify_ssl:\n    description:\n    - Specify whether Ansible should verify the SSL certificate of the controller host.\n    - Defaults to True, but this is handled by the shared module_utils code\n    type: bool\n    env:\n    - name: CONTROLLER_VERIFY_SSL\n    - name: TOWER_VERIFY_SSL\n      deprecated:\n        collection_name: 'awx.awx'\n        version: '4.0.0'\n        why: Collection name change\n        alternatives: 'CONTROLLER_VERIFY_SSL'\n    aliases: [ validate_certs ]\n\nnotes:\n- If no I(config_file) is provided we will attempt to use the tower-cli library\n  defaults to find your host information.\n- I(config_file) should be in the following format\n    host=hostname\n    username=username\n    password=password\n'''\n", "path": "awx_collection/plugins/doc_fragments/auth_plugin.py"}]}