rabbitmq_plugin for Windows (#28017)

* Fixes #28016: rabbitmq_plugin for Windows

* Disable documentation check for rabbitmq_plugin.ps1

* Renamed rabbitmq_plugin -> win_rabbitmq_plugin

* Fixed the documentation after review

* Fixed 'RETURN' section

* Fixed docs for original module

* Added dots to original module docs.

lib/ansible/modules/messaging/rabbitmq_plugin.py

@@ -16,46 +16,55 @@ ANSIBLE_METADATA = {'metadata_version': '1.0',
 DOCUMENTATION = '''
 ---
 module: rabbitmq_plugin
-short_description: Adds or removes plugins to RabbitMQ
+short_description: Manage RabbitMQ plugins
 description:
-  - Enables or disables RabbitMQ plugins
+  - Manage RabbitMQ plugins.
 version_added: "1.1"
-author: '"Chris Hoffman (@chrishoffman)"'
+author:
+  - Chris Hoffman (@chrishoffman)
 options:
   names:
     description:
-      - Comma-separated list of plugin names
+      - Comma-separated list of plugin names.
     required: true
-    default: null
     aliases: [name]
   new_only:
     description:
-      - Only enable missing plugins
-      - Does not disable plugins that are not in the names list
-    required: false
+      - Only enable missing plugins.
+      - Does not disable plugins that are not in the names list.
+    type: bool
     default: "no"
-    choices: [ "yes", "no" ]
   state:
     description:
-      - Specify if plugins are to be enabled or disabled
-    required: false
+      - Specify if plugins are to be enabled or disabled.
     default: enabled
     choices: [enabled, disabled]
   prefix:
     description:
-      - Specify a custom install prefix to a Rabbit
-    required: false
+      - Specify a custom install prefix to a Rabbit.
     version_added: "1.3"
-    default: null
 '''
 
 EXAMPLES = '''
-# Enables the rabbitmq_management plugin
-- rabbitmq_plugin:
+- name: Enables the rabbitmq_management plugin
+  rabbitmq_plugin:
     names: rabbitmq_management
     state: enabled
 '''
 
+RETURN = '''
+enabled:
+  description: list of plugins enabled during task run
+  returned: always
+  type: list
+  sample: ["rabbitmq_management"]
+disabled:
+  description: list of plugins disabled during task run
+  returned: always
+  type: list
+  sample: ["rabbitmq_management"]
+'''
+
 import os
 from ansible.module_utils.basic import AnsibleModule