summaryrefslogtreecommitdiff
path: root/docs/docsite/rst/modules_extra.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docsite/rst/modules_extra.rst')
-rw-r--r--docs/docsite/rst/modules_extra.rst22
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/docsite/rst/modules_extra.rst b/docs/docsite/rst/modules_extra.rst
new file mode 100644
index 0000000000..bcfdc62959
--- /dev/null
+++ b/docs/docsite/rst/modules_extra.rst
@@ -0,0 +1,22 @@
+Extras Modules
+--------------
+
+These modules are currently shipped with Ansible, but might be shipped separately in the future. They are also mostly maintained by the community.
+Non-core modules are still fully usable, but may receive slightly lower response rates for issues and pull requests.
+
+Popular "extras" modules may be promoted to core modules over time.
+
+The source for these modules is hosted on GitHub in the `ansible <https://github.com/ansible/ansible/tree/devel/lib/ansible/modules>`_ repo.
+
+If you believe you have found a bug in an extras module and are already running the latest stable or development version of Ansible,
+first look in the `issue tracker at github.com/ansible/ansible <http://github.com/ansible/ansible/issues>`_
+to see if a bug has already been filed. If not, we would be grateful if you could file one.
+
+Should you have a question rather than a bug report, inquiries are welcome on the `ansible-project google group <https://groups.google.com/forum/#!forum/ansible-project>`_
+or on Ansible's "#ansible" channel, located on irc.freenode.net.
+Development oriented topics should instead use the similar `ansible-devel google group <https://groups.google.com/forum/#!forum/ansible-devel>`_.
+
+Documentation updates for this module can also be edited directly in the module and by submitting a pull request to the module source code, just look for the "DOCUMENTATION" block in the source tree.
+
+For help in developing on modules, should you be so inclined, please read :doc:`community`, :doc:`developing_test_pr` and :doc:`developing_modules`.
+