[ansible-project] Visibility and documentation of ansible playbook.

2014-02-17 Thread Marcin Prączko
Dear ansible users, I am using ansible and must admit that I am quite happy with it. Challanges which I started to have are: 1. Documentation from yaml files (roles / playbook / etc). 2. Visibility what ansible will do. A bit more about this: # 1. I started using sphinx-doc for documentation

Re: [ansible-project] Visibility and documentation of ansible playbook.

2014-02-17 Thread Michael DeHaan
As I ansible user I would like to use docstrings in yaml file and quickly build documentation (the best for sphinx-doc if possible). Something like doxygen is doing for C++ code. YAML documents support comments. You could easily write a script to parse these out if you wanted, though I'd