.. _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
