diff --git a/docs/docsite/rst/dev_guide/developing_collections_creating.rst b/docs/docsite/rst/dev_guide/developing_collections_creating.rst index deff8fb1b63..c2a30b4c9a9 100644 --- a/docs/docsite/rst/dev_guide/developing_collections_creating.rst +++ b/docs/docsite/rst/dev_guide/developing_collections_creating.rst @@ -6,7 +6,7 @@ Creating collections To create a collection: -#. Create a :ref:`new collection`, optionally using a custom :ref:`collection template`, with the ``ansible-galaxy collection init`` command. +#. Create a :ref:`new collection`, optionally using a custom :ref:`collection template`, with the ``ansible-galaxy collection init`` command. #. Add modules and other content to the collection. #. Build the collection into a collection artifact with :ref:`ansible-galaxy collection build`. #. Publish the collection artifact to Galaxy with :ref:`ansible-galaxy collection publish`. @@ -79,7 +79,7 @@ Currently the ``ansible-galaxy collection`` command implements the following sub To learn more about the ``ansible-galaxy`` command-line tool, see the :ref:`ansible-galaxy` man page. -.. _creating_collection_skeletons: +.. _creating_collection_from_custom_template: Creating a collection from a custom template ============================================ @@ -111,12 +111,30 @@ To initialize a collection using the new template, pass the path to the skeleton The default collection skeleton uses an internal filter ``comment_ify`` that isn't accessibly to ``--collection-skeleton``. Use ``ansible-doc -t filter|test --list`` to see available plugins. +.. _creating_collection_with_ansible-creator: + +Creating collections with ansible-creator +========================================= + +`ansible-creator `_ is designed to quickly scaffold an Ansible collection project. + +.. note:: + + The `Ansible Development Tools `_ package offers a convenient way to install ``ansible-creator`` along with a curated set of tools for developing automation content. + +After `installing `_ ``ansible-creator`` you can initialize a project in one of the following ways: + +* Use the `init `_ subcommand. +* Use ``ansible-creator`` with the `Ansible extension `_ in Visual Studio Code. + .. seealso:: :ref:`collections` Learn how to install and use collections. :ref:`collection_structure` Directories and files included in the collection skeleton + `Ansible Development Tools (ADT) `_ + Python package of tools to create and test Ansible content. `Mailing List `_ The development mailing list :ref:`communication_irc`