summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/dev_guide/developing_collections.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 16:04:21 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-28 16:04:21 +0000
commit8a754e0858d922e955e71b253c139e071ecec432 (patch)
tree527d16e74bfd1840c85efd675fdecad056c54107 /docs/docsite/rst/dev_guide/developing_collections.rst
parentInitial commit. (diff)
downloadansible-core-upstream.tar.xz
ansible-core-upstream.zip
Adding upstream version 2.14.3.upstream/2.14.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'docs/docsite/rst/dev_guide/developing_collections.rst')
-rw-r--r--docs/docsite/rst/dev_guide/developing_collections.rst49
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/docsite/rst/dev_guide/developing_collections.rst b/docs/docsite/rst/dev_guide/developing_collections.rst
new file mode 100644
index 0000000..d3fb4f7
--- /dev/null
+++ b/docs/docsite/rst/dev_guide/developing_collections.rst
@@ -0,0 +1,49 @@
+.. _developing_collections:
+
+**********************
+Developing collections
+**********************
+
+Collections are a distribution format for Ansible content. You can package and distribute playbooks, roles, modules, and plugins using collections. A typical collection addresses a set of related use cases. For example, the ``cisco.ios`` collection automates management of Cisco IOS devices.
+
+You can create a collection and publish it to `Ansible Galaxy <https://galaxy.ansible.com>`_ or to a private Automation Hub instance. You can publish certified collections to the Red Hat Automation Hub, part of the Red Hat Ansible Automation Platform.
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Developing new collections
+
+ developing_collections_creating
+ developing_collections_shared
+ developing_collections_testing
+ developing_collections_distributing
+ developing_collections_documenting
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Working with existing collections
+
+ developing_collections_migrating
+ developing_collections_contributing
+ developing_collections_changelogs
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Collections references
+
+ developing_collections_structure
+ collections_galaxy_meta
+
+For instructions on developing modules, see :ref:`developing_modules_general`.
+
+.. seealso::
+
+ :ref:`collections`
+ Learn how to install and use collections in playbooks and roles
+ :ref:`contributing_maintained_collections`
+ Guidelines for contributing to selected collections
+ `Ansible Collections Overview and FAQ <https://github.com/ansible-collections/overview/blob/main/README.rst>`_
+ Current development status of community collections and FAQ
+ `Mailing List <https://groups.google.com/group/ansible-devel>`_
+ The development mailing list
+ :ref:`communication_irc`
+ How to join Ansible chat channels