diff --git a/collection_requirements.rst b/collection_requirements.rst index ee0eb05..d1a39e0 100644 --- a/collection_requirements.rst +++ b/collection_requirements.rst @@ -104,20 +104,25 @@ Versioning and deprecation * We recommend to announce your policy of releasing, versioning and deprecation to contributors and users in some way. For an example of how to do this, see `the announcement in community.general `_. You could also do this in the README. -Repository management -===================== - -Repository name ---------------- +Naming +====== For collections under ansible-collections the repository SHOULD be named ``NAMESPACE.COLLECTION``. +`Namespace limitations `_ lists requirements for namespaces in Galaxy. + For collections created for working with a particular entity, they should contain the entity name, for example ``community.mysql``. -We should avoid: +For corporate maintained collections, the repository can be named ``COMPANY_NAME.PRODUCT_NAME``, for example ``ibm.db2``. + +We should avoid FQCN / repository names: -* too long FQCN names: try to make it compact but clear -* nested namespaces if this is not really necessary, especially namespaces with repetitive parts +* which are unnecessary long: try to make it compact but clear +* contain the same words / collocations in ``NAMESPACE`` and ``COLLECTION`` parts, for example ``my_system.my_system`` + + +Repository management +===================== Branch name and configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~