title: How to generate a documentation from ansible-modules
body: <p>We are developing an ansible collection using ansible modules like openstack does: <a href="https://github.com/openstack/ansible-collections-openstack" rel="nofollow noreferrer">https://github.com/openstack/ansible-collections-openstack</a></p>
  <p>How can I generate docs from the modules like the ansible wiki has it? <a href="https://docs.ansible.com/ansible/2.8/modules/os_auth_module.html#os-auth-module" rel="nofollow noreferrer">https://docs.ansible.com/ansible/2.8/modules/os_auth_module.html#os-auth-module</a></p>
  <p>I found this on the internet but I can't get antsibull to work
  <a href="https://www.die-welt.net/2020/07/building-documentation-for-ansible-collections-using-antsibull/" rel="nofollow noreferrer">https://www.die-welt.net/2020/07/building-documentation-for-ansible-collections-using-antsibull/</a>
  The problem there is that despite of having the ANSIBLE_COLLECTIONS_PATH env var set it will just output an nearly empty file with <code>antsibull-docs collection --use-current --dest-dir ~/docs collectionname</code></p>
  <p>Also I don't know whether this is the right way to do that.</p>
  <p>So what can I do?</p>