Fix Ansible documentation in part of example formatting. Part 1 (#332)

* Fix Ansible documentation in part of example formatting

* Fix

plugins/modules/packaging/os/zypper.py

@@ -117,68 +117,68 @@ requirements:
 '''
 
 EXAMPLES = '''
-# Install "nmap"
-- zypper:
+- name: Install nmap
+  zypper:
     name: nmap
     state: present
 
-# Install apache2 with recommended packages
-- zypper:
+- name: Install apache2 with recommended packages
+  zypper:
     name: apache2
     state: present
     disable_recommends: no
 
-# Apply a given patch
-- zypper:
+- name: Apply a given patch
+  zypper:
     name: openSUSE-2016-128
     state: present
     type: patch
 
-# Remove the "nmap" package
-- zypper:
+- name: Remove the nmap package
+  zypper:
     name: nmap
     state: absent
 
-# Install the nginx rpm from a remote repo
-- zypper:
+- name: Install the nginx rpm from a remote repo
+  zypper:
     name: 'http://nginx.org/packages/sles/12/x86_64/RPMS/nginx-1.8.0-1.sles12.ngx.x86_64.rpm'
     state: present
 
-# Install local rpm file
-- zypper:
+- name: Install local rpm file
+  zypper:
     name: /tmp/fancy-software.rpm
     state: present
 
-# Update all packages
-- zypper:
+- name: Update all packages
+  zypper:
     name: '*'
     state: latest
 
-# Apply all available patches
-- zypper:
+- name: Apply all available patches
+  zypper:
     name: '*'
     state: latest
     type: patch
 
-# Perform a dist-upgrade with additional arguments
-- zypper:
+- name: Perform a dist-upgrade with additional arguments
+  zypper:
     name: '*'
     state: dist-upgrade
     extra_args: '--no-allow-vendor-change --allow-arch-change'
 
-# Refresh repositories and update package "openssl"
-- zypper:
+- name: Refresh repositories and update package openssl
+  zypper:
     name: openssl
     state: present
     update_cache: yes
 
-# Install specific version (possible comparisons: <, >, <=, >=, =)
-- zypper:
+- name: "Install specific version (possible comparisons: <, >, <=, >=, =)"
+  zypper:
     name: 'docker>=1.10'
     state: present
 
-# Wait 20 seconds to acquire the lock before failing
-- zypper:
+- name: Wait 20 seconds to acquire the lock before failing
+  zypper:
     name: mosh
     state: present
   environment:

plugins/modules/packaging/os/zypper_repository.py

@@ -84,34 +84,34 @@ requirements:
 '''
 
 EXAMPLES = '''
-# Add NVIDIA repository for graphics drivers
-- zypper_repository:
+- name: Add NVIDIA repository for graphics drivers
+  zypper_repository:
     name: nvidia-repo
     repo: 'ftp://download.nvidia.com/opensuse/12.2'
     state: present
 
-# Remove NVIDIA repository
-- zypper_repository:
+- name: Remove NVIDIA repository
+  zypper_repository:
     name: nvidia-repo
     repo: 'ftp://download.nvidia.com/opensuse/12.2'
     state: absent
 
-# Add python development repository
-- zypper_repository:
+- name: Add python development repository
+  zypper_repository:
     repo: 'http://download.opensuse.org/repositories/devel:/languages:/python/SLE_11_SP3/devel:languages:python.repo'
 
-# Refresh all repos
-- zypper_repository:
+- name: Refresh all repos
+  zypper_repository:
     repo: '*'
     runrefresh: yes
 
-# Add a repo and add it's gpg key
-- zypper_repository:
+- name: Add a repo and add its gpg key
+  zypper_repository:
     repo: 'http://download.opensuse.org/repositories/systemsmanagement/openSUSE_Leap_42.1/'
     auto_import_keys: yes
 
-# Force refresh of a repository
-- zypper_repository:
+- name: Force refresh of a repository
+  zypper_repository:
     repo: 'http://my_internal_ci_repo/repo'
     name: my_ci_repo
     state: present