Kirill Satarin
Kirill Satarin works as principal software engineer at Red Hat with focus on SAP automation with Ansible.
Sessions
02-02
17:15
25min
ansible-docsmith - ultimate tool to document ansible roles
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
Ansible
B.1.0.14