Add documentation about the task blueprint

docs/index.rst

@@ -34,6 +34,7 @@ Please use the navigation sidebar on the left to begin.
 
    inventory
    network
+   task
    profile
    api
    changelog

docs/network.rst

@@ -53,6 +53,9 @@ DNS and DHCP update
 -------------------
 
 Any creation or update of an host will automatically trigger an update of the core services on the Technical Network (DNS and DHCP).
+See :ref:`task`.
+
+.. _vm_creation:
 
 VM creation
 -----------

docs/task.rst

+.. _task:
+
+Task
+====
+
+CSEntry can launch some background jobs.
+Some are triggered automatically and others manually.
+
+Most tasks trigger an Ansible_ playbook on AWX_ via the API.
+AWX_ is web-based user interface, REST API and task engine build on top of Ansible_.
+
+For example, when you create a new host, a job is automatically fired to update the DHCP and DNS services.
+From the *View host* page, you can manually trigger a VM creation, see :ref:`vm_creation`.
+
+The *Task* page gives you a list of all the tasks that you triggered (admin users can see all the tasks).
+
+.. image:: _static/tasks.png
+
+Clicking on the **Id** of a task will take you to the *View task* page.
+On that page you can see all the task's details.
+It includes a link to the AWX_ job where you can find the full log of the job that was run.
+
+.. image:: _static/view_task.png
+
+If a task failed before the AWX_ job was run, the exception will be displayed:
+
+.. image:: _static/view_task_failed.png
+
+
+.. _Ansible: https://docs.ansible.com/ansible/latest/index.html
+.. _AWX: https://github.com/ansible/awx