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

@@ -30,24 +30,19 @@ DOCUMENTATION = r'''
 module: win_dsc
 version_added: "2.4"
 short_description: Invokes a PowerShell DSC configuration
-description: |
+description:
-     Invokes a PowerShell DSC Configuration. Requires PowerShell version 5 (February release or newer).
+    - 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.
+    - 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.
 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: |
+    description:
-      Can be used to configure the exact version of the dsc resource to be invoked.
+      - 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.
+      - 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.
+      - If not specified, the module will follow standard Powershell convention and use the highest version available.
     default: latest
 author: Trond Hindenes
 '''