Ansible-mdgen is a package used to auto generate documentation for an ansible role.
pip install ansible-mdgen
Call ansible-mdgen passing in the path to the role
ansible-mdgen <path_to_role>
See here for full documentation.
The idea for this project is based on (and includes some code from) ansible-autodoc by Andres Bott so credit to him for his work.