Docs: dash - character invalid in playbook names in collections(#75891)

* collection playbooks, note no -
fixes #75890
pull/76070/head
Brian Coca 3 years ago committed by GitHub
parent 9eeaf1c5b5
commit ff792d252e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -371,6 +371,11 @@ A few recommendations when creating such playbooks, ``hosts:`` should be generic
This will have an implied entry in the ``collections:`` keyword of ``my_namespace.my_collection`` just as with roles. This will have an implied entry in the ``collections:`` keyword of ``my_namespace.my_collection`` just as with roles.
.. note::
Playbook names, like other collection resources, have a restricted set of valid characters.
Names can contain only lowercase alphanumeric characters, plus _ and must start with an alpha character. The dash ``-`` character is not valid for playbook names in collections.
Playbooks whose names contain invalid characters are not addressable: this is a limitation of the Python importer that is used to load collection resources.
.. seealso:: .. seealso::
:ref:`developing_collections` :ref:`developing_collections`

Loading…
Cancel
Save