summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/plugins/docs_fragment.rst
blob: 546229bee7987f6d04980054d7d58b1b8ffe1cfe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
.. _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`
       An guide to creating Ansible collections
   `User Mailing List <https://groups.google.com/group/ansible-devel>`_
       Have a question?  Stop by the google group!
   :ref:`communication_irc`
       How to join Ansible chat channels