I was wondering if it isn't time to define a standard of documenting 
playbooks and roles?

I discussed this about 2.5-3 years ago with Michael and he didn't care for 
that, at that time.
But at this moment in time everybody is creating a way to embed 
documentation in playbooks and roles. And everybody has their own way, which
could break things like the Galaxy.

I think we should create a standard. And my proposol would be to have 
something like a Python Docstring, containing reStructuredText that can be 
processed with Sphinx.

-- 
You received this message because you are subscribed to the Google Groups 
"Ansible Development" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to