Disclaimer: I have no associattion with the Ansible org other than being a user of their application.
On Wed, Jan 7, 2015 at 3:36 PM, Stuart Budd <[email protected]> wrote: > Everyone else manages to provide PDF versions and really it is the > professional thing to do. The three examples you gave earlier (Redhat, Oracle, CFEngine) of "everyone" that provides PDF documentation are all vastly larger organizations with many, many more resources to throw at documentation than Ansible has. Ansible has limited resources to deal with this sort of thing and they've chosen to stick with a single "authoritative" documentation source. > Other organisations manage to provide PDF versions for operating systems. > This is an application. It is far less complex than an OS. Yes indeed, far less complex. But complexity isn't the problem - rate of change is the problem. I'm not certain how often Ansible re-generates their documentation, but it may be as often as with each merged pull request. For Redhat, the rate of change is *very* slow. They probably re-generate their documentation once a quarter or less. > All software changes. To not provide adequate documentation and use the fact > that there are ongoing changes is not really very good in my opinion. Ansible *does* provide very adequate documentation - some of the best in the industry. Accusing them of not providing adequate documentation seems a bit disingenuous. Their documentation is just not in your preferred format. That's OK. My preference is to have html documentation. I suspect the vast majority of Ansible users feel the same way, which is another reason why the documentation is in that format. You're always free to take the RST sources[1] and generate PDF docs for yourself. Heck, you can even take the work done by Matt in pull request 8906 that he linked to earlier, and use that as your starting point. -ea [1] https://github.com/ansible/ansible/tree/devel/docsite/rst -- You received this message because you are subscribed to the Google Groups "Ansible Project" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/ansible-project/CADdM08o%2BpJXbwW2XUsWW1CK6gx%2BQ9VCx_iML3x-p8HgWZ8R-NA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
