Fix Ansible documentation in part of example formatting (#334)

plugins/modules/cloud/profitbricks/profitbricks.py

@@ -115,9 +115,9 @@ EXAMPLES = '''
 
 # Note: These examples do not set authentication details, see the AWS Guide for details.
 
-# Provisioning example. This will create three servers and enumerate their names.
-
-- profitbricks:
+# Provisioning example
+- name: Create three servers and enumerate their names
+  profitbricks:
     datacenter: Tardis One
     name: web%02d.stackpointcloud.com
     cores: 4
@@ -129,9 +129,8 @@ EXAMPLES = '''
     count: 3
     assign_public_ip: true
 
-# Removing Virtual machines
-
-- profitbricks:
+- name: Remove virtual machines
+  profitbricks:
     datacenter: Tardis One
     instance_ids:
       - 'web001.stackpointcloud.com'
@@ -140,9 +139,8 @@ EXAMPLES = '''
     wait_timeout: 500
     state: absent
 
-# Starting Virtual Machines.
-
-- profitbricks:
+- name: Start virtual machines
+  profitbricks:
     datacenter: Tardis One
     instance_ids:
       - 'web001.stackpointcloud.com'
@@ -151,9 +149,8 @@ EXAMPLES = '''
     wait_timeout: 500
     state: running
 
-# Stopping Virtual Machines
-
-- profitbricks:
+- name: Stop virtual machines
+  profitbricks:
     datacenter: Tardis One
     instance_ids:
       - 'web001.stackpointcloud.com'
@@ -161,7 +158,6 @@ EXAMPLES = '''
       - 'web003.stackpointcloud.com'
     wait_timeout: 500
     state: stopped
-
 '''
 
 import re

plugins/modules/cloud/profitbricks/profitbricks_datacenter.py

@@ -58,18 +58,16 @@ author: Matt Baldwin (@baldwinSPC) <baldwin@stackpointcloud.com>
 '''
 
 EXAMPLES = '''
-
-# Create a Datacenter
-- profitbricks_datacenter:
+- name: Create a datacenter
+  profitbricks_datacenter:
     datacenter: Tardis One
     wait_timeout: 500
 
-# Destroy a Datacenter. This will remove all servers, volumes, and other objects in the datacenter.
-- profitbricks_datacenter:
+- name: Destroy a datacenter (remove all servers, volumes, and other objects in the datacenter)
+  profitbricks_datacenter:
     datacenter: Tardis One
     wait_timeout: 500
     state: absent
-
 '''
 
 import re

plugins/modules/cloud/profitbricks/profitbricks_nic.py

@@ -59,23 +59,21 @@ author: Matt Baldwin (@baldwinSPC) <baldwin@stackpointcloud.com>
 '''
 
 EXAMPLES = '''
-
-# Create a NIC
-- profitbricks_nic:
+- name: Create a NIC
+  profitbricks_nic:
     datacenter: Tardis One
     server: node002
     lan: 2
     wait_timeout: 500
     state: present
 
-# Remove a NIC
-- profitbricks_nic:
+- name: Remove a NIC
+  profitbricks_nic:
     datacenter: Tardis One
     server: node002
     name: 7341c2454f
     wait_timeout: 500
     state: absent
-
 '''
 
 import re

plugins/modules/cloud/profitbricks/profitbricks_volume.py

@@ -100,10 +100,8 @@ author: Matt Baldwin (@baldwinSPC) <baldwin@stackpointcloud.com>
 '''
 
 EXAMPLES = '''
-
-# Create Multiple Volumes
-
-- profitbricks_volume:
+- name: Create multiple volumes
+  profitbricks_volume:
     datacenter: Tardis One
     name: vol%02d
     count: 5
@@ -111,16 +109,14 @@ EXAMPLES = '''
     wait_timeout: 500
     state: present
 
-# Remove Volumes
-
-- profitbricks_volume:
+- name: Remove Volumes
+  profitbricks_volume:
     datacenter: Tardis One
     instance_ids:
       - 'vol01'
       - 'vol02'
     wait_timeout: 500
     state: absent
-
 '''
 
 import re

plugins/modules/cloud/profitbricks/profitbricks_volume_attachments.py

@@ -55,25 +55,21 @@ author: Matt Baldwin (@baldwinSPC) <baldwin@stackpointcloud.com>
 '''
 
 EXAMPLES = '''
-
-# Attach a Volume
-
-- profitbricks_volume_attachments:
+- name: Attach a volume
+  profitbricks_volume_attachments:
     datacenter: Tardis One
     server: node002
     volume: vol01
     wait_timeout: 500
     state: present
 
-# Detach a Volume
-
-- profitbricks_volume_attachments:
+- name: Detach a volume
+  profitbricks_volume_attachments:
     datacenter: Tardis One
     server: node002
     volume: vol01
     wait_timeout: 500
     state: absent
-
 '''
 
 import re