I have started using #ansible to set up severs for clients. Would it be wrong of me to automatically generate documentation from the yaml content of the playbook? Seems hacky? But manually writing docs after automating install seems silly...


Hi @ebel

How would you go about this?

Appart from the Inventory and the parsing of your Playbooks you could come up with a Play/Role that create Documentation based on Templates, Facts, variables and stuff, utilizing the setup module you could build a generic drop in System.

Oh, also this might be of use for you github.com/fboender/ansible-cm (did not test it myself though!)

Sign in to participate in the conversation

Server run by the main developers of the project 🐘 It is not focused on any particular niche interest - everyone is welcome as long as you follow our code of conduct!