bitshift🚀 New release v2.0.2: DocSmith for Ansible: A documentation generator for roles that reads your role's meta/argument_specs.yml and auto-creates:
• variable docs in README.md
• inline comment blocks for defaults/main.yml
Examples: https://foundata.com/en/projects/ansible-docsmith/#demo
Works with stand-alone roles & collections. Includes validation, CI/CD friendly, and `--dry-run` with diff.
Get it: https://github.com/foundata/ansible-docsmith
Install: pip install ansible-docsmith
DocSmith for Ansible
DocSmith is a documentation generator. It reads an Ansible role’s meta/argument_specs.yml and produces up‑to‑date variable descriptions for the README.md as well as inline comment blocks for defaults/main.yml (or other role entry-point files). It works with roles in both stand‑alone form and within collections.