From 097f198ef45aa2be8b8bb6349e7ca79b7750c51b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kriszti=C3=A1n=20Szab=C3=B3?= Date: Wed, 1 May 2024 20:34:32 +0200 Subject: [PATCH] doc: move ansible-creator section, rename anchor --- .../developing_collections_creating.rst | 34 ++++++++++--------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/docs/docsite/rst/dev_guide/developing_collections_creating.rst b/docs/docsite/rst/dev_guide/developing_collections_creating.rst index 29ec5f5a5cb..bfa99c3e168 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,21 +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 collections with ansible-creator -========================================= - -`ansible-creator `_ is designed to quickly scaffold an Ansible collection project. - -.. note:: - - We recommend you install ``ansible-creator`` through the `Ansible Development Tools `_ package. - -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. +.. _creating_collection_from_custom_template: Creating a collection from a custom template ============================================ @@ -125,6 +111,22 @@ 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:: + + We recommend you install ``ansible-creator`` through the `Ansible Development Tools `_ package. + +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`