Back to Ansible

Docs fragments

docs/docsite/rst/plugins/docs_fragment.rst

2.21.0b31001 B
Original Source

.. _docs_fragment_plugins:

Docs fragments

.. contents:: :local: :depth: 2

Docs fragments allow you to document common parameters of multiple plugins or modules in a single place.

.. _enabling_docs_fragments:

Enabling docs fragments

You can add a custom docs fragment by dropping it into a doc_fragments directory adjacent to your collection or role, just like any other plugin.

.. _using_docs_fragments:

Using docs fragments

Only collection developers and maintainers use docs fragments. For more information on using docs fragments, see :ref:module_docs_fragments or :ref:docfragments_collections.

.. seealso::

:ref:developing_modules_general An introduction to creating Ansible modules :ref:developing_collections A guide to creating Ansible collections :ref:Communication<communication> Got questions? Need help? Want to share your ideas? Visit the Ansible communication guide