Skip to content

Commit d9e034c

Browse files
collection requirements/steering committee inclusion policy: change (#995)
* collection requirements/steering committee inclusion policy: change * Update docs/docsite/rst/community/collection_contributors/collection_requirements.rst Co-authored-by: Felix Fontein <[email protected]> * Update docs/docsite/rst/community/steering/community_steering_committee.rst Co-authored-by: Felix Fontein <[email protected]> * Incorporate feedback --------- Co-authored-by: Felix Fontein <[email protected]>
1 parent 940152c commit d9e034c

File tree

2 files changed

+7
-0
lines changed

2 files changed

+7
-0
lines changed

docs/docsite/rst/community/collection_contributors/collection_requirements.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -528,6 +528,7 @@ Other requirements
528528
===================
529529

530530
* After content is moved out of another currently included collection such as ``community.general`` or ``community.network`` OR a new collection satisfies all the requirements, see `Adding a new collection <https://github.com/ansible-community/ansible-build-data/#adding-a-new-collection>`_ in the `ansible-build-data repository <https://github.com/ansible-community/ansible-build-data/>`_'s README.
531+
* :ref:`The Steering Committee <steering_responsibilities>` can reject a collection inclusion request or exclude a collection from the Ansible package even if the collection satisfies the requirements listed in this document. See the :ref:`Collection inclusion request workflow<steering_inclusion>` for details.
531532

532533
.. seealso::
533534

docs/docsite/rst/community/steering/community_steering_committee.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,11 +133,17 @@ A person starting the triage:
133133
#. Establishes a vote date considering a number of topics, their complexity and comment-history size giving the Community sufficient time to go through and discuss them.
134134
#. The Community and the Committee vote on each topic-candidate listed in the triage topic whether to close it or keep it open.
135135

136+
.. _steering_inclusion:
137+
136138
Collection inclusion requests workflow
137139
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
138140

139141
When reviewing community collection `inclusion requests <https://github.com/ansible-collections/ansible-inclusion/discussions>`_, the Committee members check if a collection adheres to the :ref:`collections_requirements`.
140142

143+
.. note::
144+
145+
The Steering Committee can reject a collection inclusion request or exclude a collection from the Ansible package even when the collection satisfies the requirements if the Steering Committee agrees that presence of the collection will significantly deteriorate the Ansible package user experience or the package build process. In case of rejection/removal, the collection maintainers receive comprehensive feedback from the Committee explaining the reasons of starting the process. In case the reasons are fixable, the feedback will contain information what the maintainers need to change.
146+
141147
#. A Committee member who conducts the inclusion review copies the `Ansible community collection checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_ into a corresponding `discussion <https://github.com/ansible-collections/ansible-inclusion/discussions>`_.
142148

143149
#. In the course of the review, the Committee member marks items as completed or leaves a comment saying whether the reviewer expects an issue to be addressed or whether it is optional (for example, it could be **MUST FIX:** <what> or **SHOULD FIX:** <what> under an item).

0 commit comments

Comments
 (0)