Automate Documentation

From http://docs.ansible.com/ansible/latest/intro.html, the page footer reads:

Ansible docs are generated from GitHub sources using Sphinx using a theme provided by Read the Docs.

Ansible’s integration page doesn’t include documentation as an integration point. In the attached diagram, Pandoc is equivalent to Sphinx, but Sphinx only parses one Markdown flavour; whereas, Pandoc imports and exports many formats.

If Ansible could automate documentation, though I’m not sure if it is possible, then the footers of Ansible’s documentation could state, Ansible docs were automatically generated and published using Ansible and Sphinx.

Kind regards,
Dave

(attachments)