summaryrefslogtreecommitdiff
path: root/docs/docsite/rst/modules.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docsite/rst/modules.rst')
-rw-r--r--docs/docsite/rst/modules.rst33
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/docsite/rst/modules.rst b/docs/docsite/rst/modules.rst
new file mode 100644
index 0000000000..6988fac8dc
--- /dev/null
+++ b/docs/docsite/rst/modules.rst
@@ -0,0 +1,33 @@
+About Modules
+=============
+
+.. toctree::
+ :maxdepth: 1
+
+ modules_intro
+ modules_core
+ modules_extra
+ common_return_values
+
+
+Ansible ships with a number of modules (called the 'module library')
+that can be executed directly on remote hosts or through :doc:`Playbooks <playbooks>`.
+
+Users can also write their own modules. These modules can control system resources,
+like services, packages, or files (anything really), or handle executing system commands.
+
+
+.. seealso::
+
+ :doc:`intro_adhoc`
+ Examples of using modules in /usr/bin/ansible
+ :doc:`playbooks`
+ Examples of using modules with /usr/bin/ansible-playbook
+ :doc:`developing_modules`
+ How to write your own modules
+ :doc:`developing_api`
+ Examples of using modules with the Python API
+ `Mailing List <http://groups.google.com/group/ansible-project>`_
+ Questions? Help? Ideas? Stop by the list on Google Groups
+ `irc.freenode.net <http://irc.freenode.net>`_
+ #ansible IRC chat channel