[check_latest_packages_version] Add role documentation in sphinx

This patch adds the documentation directly in the sphinx role
documentation index. All variables have been commented with a proper
description to be included automatically in the sphinx build.

Change-Id: Ia24af3f62fcb4de2bbe2004117afe3a6ede40762
Signed-off-by: Gael Chamoulaud (Strider) <gchamoul@redhat.com>

doc/source/roles/role-check_latest_packages_version.rst

@@ -2,5 +2,49 @@
 check_latest_packages_version
 =============================
 
+--------------
+About The Role
+--------------
+
+An Ansible role to check if latest version of a list of packages is installed.
+
+Requirements
+============
+
+No requirements.
+
+Dependencies
+============
+
+No dependencies.
+
+Example Playbook
+================
+
+.. code-block:: yaml
+
+   - hosts: localhost
+     gather_facts: false
+     vars:
+       packages_list:
+         - coreutils
+         - wget
+     roles:
+       - check_latest_packages_version
+
+License
+=======
+
+Apache
+
+Author Information
+==================
+
+**Red Hat TripleO DFG:DF Squad:VF**
+
+----------------
+Full Description
+----------------
+
 .. ansibleautoplugin::
    :role: validations_common/roles/check_latest_packages_version

validations_common/roles/check_latest_packages_version/defaults/main.yml

@@ -1,2 +1,4 @@
 ---
+# List of packages to check.
+# Empty list by default
 packages_list: []