{"categories":[{"label":"Sphinx","url":"https://skillfed.io/packages/category/documentation-sphinx"}],"enrichment":{"capability":"Builds and generates Ansible documentation from source, providing a command-line tool and Sphinx extension for processing Ansible markup into formatted documentation.","skillfed_tags":["ansible-tooling","documentation-generation","sphinx-extension"],"use_cases":["Building official Ansible project documentation using the antsibull-docs command-line tool","Integrating Ansible documentation generation into a Sphinx-based documentation pipeline via the sphinx_antsibull_ext extension","Processing and validating Ansible markup and changelog fragments as part of a release workflow","Generating formatted HTML or other output formats from Ansible source documentation","Contributing to Ansible community documentation that relies on this toolchain"],"what_it_does":"antsibull-docs is a toolchain for building Ansible project documentation. It provides both a command-line interface (`antsibull-docs`) and a Sphinx extension (`sphinx_antsibull_ext`) that handle the specialized markup and formatting needs of Ansible documentation. The package depends on Sphinx, Jinja2, docutils, and several sister antsibull projects (antsibull-core, antsibull-changelog, antsibull-docs-parser, antsibull-docutils, antsibull-fileutils) to parse, validate, and render Ansible-specific documentation elements.\n\nIt is actively maintained and marked as production-stable, supporting Python 3.9 through 3.14. The project explicitly states it is not intended for use as a general library\u2014it is a command-line and Sphinx extension tool for the Ansible documentation ecosystem. The codebase follows semantic versioning from 1.0.0 onward, with the current major version 2.x dropping support for older Python and Ansible versions.","worth_installing":"Yes, if you are building or maintaining Ansible documentation. The package is actively maintained, has no known vulnerabilities, installs with low friction, and is production-stable. The GPL-3.0-or-later license is appropriate for open-source Ansible projects but requires review for proprietary use. Not recommended for general-purpose documentation building outside the Ansible ecosystem, as it is purpose-built and not designed as a reusable library."},"id":"antsibull-docs","links":{"html":"https://skillfed.io/packages/antsibull-docs","md":"https://skillfed.io/packages/antsibull-docs.md","pypi":"https://pypi.org/project/antsibull-docs/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-08-14","license_spdx":"GPL-3.0-or-later","license_treatment":"copyleft","name":"antsibull-docs","python_support":"supports_current","summary":"Tools for building Ansible documentation"},"popularity":{"monthly_downloads":156871,"position":10773,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"2.26.0"}
