Скачать или смотреть ansible-docsmith - ultimate tool to document ansible roles

CfgMgmtCamp 2026: https://forum.ansible.com/t/cfgmgmtca...

by Kirill Satarin

Maintaining accurate, up-to-date documentation for Ansible roles is a persistent challenge when maintaining ansible roles. ansible-docsmith solves this problem by automating documentation generation from a single source of truth - argument_specs.yml file.

In this talk, we'll explore ansible-docsmith and how to use it to forget about ever updating the readme.md file for the role, but always keeping it up to date.

Using argument_specs.yml as the single source of truth for ansible role readme.md file
Using ansible-docsmith in CI/CD: automation pipelines and pre-commit hooks, making documentation updates effortless
Available customization options in ansible-docsmith: how to use Jinja2 templates to generate readme.md according to your specific documentation standards
Compare ansible-docsmith with ansibull-docs - pros and cons, use case scenarios


CfgMgmtCamp 2026: https://forum.ansible.com/t/cfgmgmtca...