Suggestion: version-specific documentation

15 views
Skip to first unread message

Guy Knights

unread,
Mar 9, 2017, 3:35:49 PM3/9/17
to ansible...@googlegroups.com
One thing I find a little frustrating about the online documentation for Ansible is that there's no way to look at the docs for a specific version. I realise that a lot of people just use the devel branch but there are those of us that stick to a specific version.

When I'm looking at the docs for a particular module it's easy to overlook the notes specifying which version of Ansible that module or module parameter was added as they're spread throughout the module documentation page.

I think it would be better to have separate docs per major version, like the Apache docs for example (https://httpd.apache.org/docs/). There could also be a "latest" version for the devel branch.

I did a bit of a search through the mailing list and found this thread from 2013 discussing the same thing but it doesn't look like it came to fruition:


Regards,
Guy

Brian Coca

unread,
Mar 9, 2017, 3:49:43 PM3/9/17
to Ansible Project
One thing that guarantees that the docs are specific to your version
`ansible-doc` it shows the same module docs (same info is used to
render html) but uses your 'current' modules.


----------
Brian Coca
Reply all
Reply to author
Forward
0 new messages