From 7cc38e1b32ee3eeee1f2ea8899b22f0926f606a1 Mon Sep 17 00:00:00 2001
From: Trond Hindenes <trond@hindenes.com>
Date: Tue, 27 Jun 2017 00:42:31 +0200
Subject: [PATCH] Fixes win_dsc docs (#26122)

* hacking dsc docs

* remove code snippet

* again...

* more testing

* trying a short version

* moar text
---
 lib/ansible/modules/windows/win_dsc.py | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/lib/ansible/modules/windows/win_dsc.py b/lib/ansible/modules/windows/win_dsc.py
index 0e438179b2a..71c8b08de81 100644
--- a/lib/ansible/modules/windows/win_dsc.py
+++ b/lib/ansible/modules/windows/win_dsc.py
@@ -30,24 +30,19 @@ DOCUMENTATION = r'''
 module: win_dsc
 version_added: "2.4"
 short_description: Invokes a PowerShell DSC configuration
-description: |
-     Invokes a PowerShell DSC Configuration. Requires PowerShell version 5 (February release or newer).
-     Most of the parameters for this module are dynamic and will vary depending on the DSC Resource.
-     In order to find the required parameters for a given DSC resource, you can use the following on-liner:
-     'Get-DscResource <dsc_resource> | select -ExpandProperty properties'
-     Also note that credentials are handled as follows: If the resource accepts a credential type property called "cred",
-     the ansible parameters would be cred_username and cred_password.
-     These will be used to inject a credential object on the fly for the DSC resource.
+description:
+    - Invokes a PowerShell DSC Configuration. Requires PowerShell version 5 (February release or newer).
+    - Most of the parameters for this module are dynamic and will vary depending on the DSC Resource.
 options:
   resource_name:
     description:
       - The DSC Resource to use. Must be accessible to PowerShell using any of the default paths.
     required: true
   module_version:
-    description: |
-      Can be used to configure the exact version of the dsc resource to be invoked.
-      Useful if the target node has multiple versions installed of the module containing the DSC resource.
-      If not specified, the module will follow standard Powershell convention and use the highest version available.
+    description:
+      - Can be used to configure the exact version of the dsc resource to be invoked.
+      - Useful if the target node has multiple versions installed of the module containing the DSC resource.
+      - If not specified, the module will follow standard Powershell convention and use the highest version available.
     default: latest
 author: Trond Hindenes
 '''