Docs: is there a consistent doc how to make a new collection up and running?

[Andersson007]

Docs: is there a consistent doc under https://docs.ansible.com/ansible/devel/community about how to make a new collection up and running?

If not create it.

Among other thing should cover:

• Request to create a skeleton / move a repo under the ansible-collections org
• Setup CI (AZP / GHA)
• Automated publishing on Galaxy via Zuul
• ...

[Andersson007]

The following email to one of partners can be used:

You can use the following sources:

• the collection_template repository to create a collection skeleton for your collection. You can create it in your org repo or under https://github.com/ansible-collections/ (in this case, create an issue in the overview repo with a request to create a new repo)
• the Collection development guidelines.
• the Collection requirements to make your collection satisfying them from the beginning (there's also a shorter version aka the Collection checklist) that can be helpful for inclusion to Ansible in the future
• when developing your modules and plugins follow the best practices described in https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_documenting.html and https://docs.ansible.com/ansible/devel/dev_guide/style_guide/index.html
• you can maintain you collection following https://docs.ansible.com/ansible/devel/community/maintainers.html, in particular you can be interested in releasing
• the Integration testing guide and Unit testing guide to cover your collection with tests
• you can find examples of collection repositories currently included in the ansible package within the ansible-collections repo, e.g. https://github.com/ansible-collections/community.dns
• when your collection satisfies the Collection requirements mentioned above, you can submit it for inclusion in the ansible package by creating a discussion in the ansible-inclusion repo (read its README first)

[Andersson007]

Also add info how to request a namespace https://github.com/ansible-collections/overview/blob/main/collection_requirements.rst#naming

[samccann]

This should be in the dev guide, not the community/contributor guides. We can add pointers from the contrib guide to the dev guide.

[Andersson007]

This should be in the dev guide, not the community/contributor guides. We can add pointers from the contrib guide to the dev guide.

OK, i'll take it into consideration, thanks

[Andersson007]

• Create an MD version of the RST collection_creator_path: add a doc ansible/community-docs#64
• Compare with https://docs.ansible.com/ansible/devel/dev_guide/developing_collections.html#developing-collections
• Publish on the Forum
• UPDATE: or merge the docs if possible / acceptable instead

[Andersson007]

the path has been merged, I made the announcement.
So closing this as complete. @samccann thanks for your contribution!