Skip to content

Commit

Permalink
Update community topics links (#1451)
Browse files Browse the repository at this point in the history
* Update community topics links

* fix

* fix

* fix

* Update docs/docsite/rst/community/contributor_path.rst

Co-authored-by: Don Naro <dnaro@redhat.com>

* Fix

---------

Co-authored-by: Don Naro <dnaro@redhat.com>
  • Loading branch information
Andersson007 and oraNod committed May 16, 2024
1 parent 1153c4e commit 83b7c12
Show file tree
Hide file tree
Showing 9 changed files with 22 additions and 18 deletions.
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
..
THIS DOCUMENT IS OWNED BY THE ANSIBLE COMMUNITY STEERING COMMITTEE. ALL CHANGES MUST BE APPROVED BY THE STEERING COMMITTEE!
For small changes (fixing typos, language errors, etc.) create a PR and ping @ansible/steering-committee.
For other changes, create a discussion in https://github.com/ansible-community/community-topics/ to discuss the changes.
For other changes, create a :ref:`topic<creating_community_topic>` on the Forum to discuss the changes.
(Creating a draft PR for this file and mentioning it in the community topic is also OK.)
.. _collections_requirements:
Expand All @@ -23,7 +23,7 @@ This section provides help, advice, and guidance on making sure your collections

.. note::

`Inclusion of a new collection <https://github.com/ansible-collections/ansible-inclusion>`_ in the Ansible package is ultimately at the discretion of the :ref:`community_steering_committee`. Every rejected candidate will get feedback. Differences of opinion should be taken to a dedicated `Community Topic <https://github.com/ansible-community/community-topics/issues>`_ for discussion and a final vote.
`Inclusion of a new collection <https://github.com/ansible-collections/ansible-inclusion>`_ in the Ansible package is ultimately at the discretion of the :ref:`community_steering_committee`. Every rejected candidate will get feedback. Differences of opinion should be taken to a dedicated :ref:`community topic<creating_community_topic>` for discussion and a final vote.

Feedback and communications
==============================
Expand Down
12 changes: 7 additions & 5 deletions docs/docsite/rst/community/communication.rst
Original file line number Diff line number Diff line change
Expand Up @@ -194,16 +194,18 @@ If you also need a real-time chat channel, you can `request one <https://hackmd.
Ansible Community Topics
========================

The `Ansible Community Steering Committee <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_ uses the `community-topics repository <https://github.com/ansible-community/community-topics/issues>`_ to asynchronously discuss with the Community and vote on Community topics in corresponding issues.
The :ref:`Ansible Community Steering Committee<steering_responsibilities>` uses the :ref:`ansible_forum` to asynchronously discuss with the Community and vote on Community topics.

Create a new issue in the `repository <https://github.com/ansible-community/community-topics/issues>`_ if you want to discuss an idea that impacts any of the following:
Create a `new topic <https://forum.ansible.com/new-topic?category=project&tags=community-wg>`_ if you want to discuss an idea that impacts any of the following:

* Ansible Community
* Community collection best practices and `requirements <https://docs.ansible.com/ansible/devel/community/collection_contributors/collection_requirements.html>`_
* `Community collection inclusion policy <https://github.com/ansible-collections/ansible-inclusion/blob/main/README.md>`_
* `The Community governance <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_
* Community collection best practices and :ref:`requirements<collections_requirements>`
* :ref:`Community collection inclusion policy<steering_inclusion>`
* :ref:`The Community governance<steering_responsibilities>`
* Other proposals of importance that need the Committee or overall Ansible community attention

See the `Community topics workflow <https://forum.ansible.com/new-topic?category=project&tags=community-wg>`_ to learn more.

Ansible Automation Platform support questions
=============================================

Expand Down
6 changes: 3 additions & 3 deletions docs/docsite/rst/community/contributor_path.rst
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ See :ref:`communication` for ways to communicate and engage with the Ansible com
Teach others
============

Share your experience with other contributors through :ref:`improving documentation<community_documentation_contributions>`, answering questions from other contributors and users on :ref:`Matrix/Libera.Chat IRC<communication>`, giving advice on issues and pull requests, and discussing `Community Topics <https://github.com/ansible-community/community-topics/issues>`_.
Share your experience with other contributors through :ref:`improving documentation<community_documentation_contributions>`, answering questions from other contributors and users on :ref:`Matrix/Libera.Chat IRC<communication>`, giving advice on issues and pull requests, and discussing topics on the :ref:`ansible_forum`.

Become a collection maintainer
===============================
Expand All @@ -105,10 +105,10 @@ Become a steering committee member

You do NOT have to be a programmer to become a steering committee member.

The :ref:`Steering Committee <community_steering_committee>` member status reflects the highest level of trust which allows contributors to lead the project by making very important `decisions <https://github.com/ansible-community/community-topics/issues>`_ for the Ansible project. The Committee members are the community leaders who shape the project's future and the future of automation in the IT world in general.
The :ref:`Steering Committee <community_steering_committee>` member status reflects the highest level of trust and allows contributors to lead the project by making important decisions for the Ansible project. The Committee members are community leaders who shape the project's future and the future of automation in the IT world in general.

To reach the status, as the current Committee members did before getting it, along with the things mentioned in this document, you should:

* Subscribe to, comment on, and vote on the `Community Topics <https://github.com/ansible-community/community-topics/issues>`_.
* Subscribe to, comment on, and vote on the `community topics<creating_community_topic>`.
* Propose your topics.
* If time permits, join the `Community meetings <https://github.com/ansible-community/meetings/blob/main/README.md#schedule>`_. Note this is **NOT** a requirement.
2 changes: 1 addition & 1 deletion docs/docsite/rst/community/maintainers_guidelines.rst
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ See the :ref:`Communication guide <communication_irc>` to learn more about real-
Community Topics
----------------

The Community and the `Steering Committee <https://docs.ansible.com/ansible/devel/community/steering/community_steering_committee.html>`_ asynchronously discuss and vote on the `Community Topics <https://github.com/ansible-community/community-topics/issues>`_ which impact the whole project or its parts including collections and packaging.
The Community and the :ref:`Steering Committee <steering_responsibilitie>` asynchronously discuss and vote on the :ref:`community topics<creating_community_topic>` which impact the whole project or its parts including collections and packaging.

Share your opinion and vote on the topics to help the community make the best decisions.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,12 +70,14 @@ John Barker (`gundalow <https://github.com/gundalow>`_) has been elected by the

Committee members are selected based on their active contribution to the Ansible Project and its community. See :ref:`community_steering_guidelines` to learn details.

.. _creating_community_topic:

Creating new policy proposals & inclusion requests
----------------------------------------------------

The Committee uses the `Ansible Forum <https://forum.ansible.com/>`_ to asynchronously discuss with the Community and vote on the proposals in corresponding `community topics <https://forum.ansible.com/tags/c/project/7/community-wg>`_.

You can create a `community topic <https://forum.ansible.com/new-topic?category=project&tags=community-wg>`_ if you want to discuss an idea that impacts any of the following:
You can `create a community topic <https://forum.ansible.com/new-topic?category=project&tags=community-wg>`_ (make sure you use the ``Project Discussions`` category and the ``community-wg`` tag) if you want to discuss an idea that impacts any of the following:

* Ansible Community
* Community collection best practices and requirements
Expand All @@ -98,6 +100,8 @@ Depending on a topic you want to discuss with the Community and the Committee, a
* :ref:`collections_requirements`.
* `Ansible Collection Inclusion Checklist <https://github.com/ansible-collections/overview/blob/main/collection_checklist.md>`_.

.. _community_topics_workflow:

Community topics workflow
^^^^^^^^^^^^^^^^^^^^^^^^^

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,6 @@
For other changes, create a `community topic <https://forum.ansible.com/new-topic?category=project&tags=community-wg>`_ to discuss them.
(Creating a draft PR for this file and mentioning it in the community topic is also OK.)
.. _community_topics_workflow:

Ansible community topics workflow
=================================

Expand Down Expand Up @@ -118,7 +116,7 @@ Implementation stage

* Checks if there is a corresponding milestone in the `ansible-build-data <https://github.com/ansible-community/ansible-build-data/milestones>`_ repository. If there is no milestone, the person creates it.

* Creates an issue in ansible-build-data that references the topic in community-topics, and adds it to the milestone.
* Creates an issue in ansible-build-data that references the :ref:`community topic<creating_community_topic>`, and adds it to the milestone.

Tools
-----
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
..
THIS DOCUMENT IS OWNED BY THE ANSIBLE COMMUNITY STEERING COMMITTEE. ALL CHANGES MUST BE APPROVED BY THE STEERING COMMITTEE!
For small changes (fixing typos, language errors, etc.) create a PR and ping @ansible/steering-committee.
For other changes, create a discussion in https://github.com/ansible-community/community-topics/ to discuss the changes.
For other changes, create a :ref:`community topic<creating_community_topic>` to discuss the changes.
(Creating a draft PR for this file and mentioning it in the community topic is also OK.)
.. _community_steering_guidelines:
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
..
THIS DOCUMENT IS OWNED BY THE ANSIBLE COMMUNITY STEERING COMMITTEE. ALL CHANGES MUST BE APPROVED BY THE STEERING COMMITTEE!
For small changes (fixing typos, language errors, etc.) create a PR and ping @ansible/steering-committee.
For other changes, create a discussion in https://github.com/ansible-community/community-topics/ to discuss the changes.
For other changes, create a :ref:`community topic<creating_community_topic>` to discuss the changes.
(Creating a draft PR for this file and mentioning it in the community topic is also OK.)
.. _steering_past_members:
Expand Down
2 changes: 1 addition & 1 deletion docs/docsite/rst/community/steering/steering_index.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
..
THIS DOCUMENT IS OWNED BY THE ANSIBLE COMMUNITY STEERING COMMITTEE. ALL CHANGES MUST BE APPROVED BY THE STEERING COMMITTEE!
For small changes (fixing typos, language errors, etc.) create a PR and ping @ansible/steering-committee.
For other changes, create a discussion in https://github.com/ansible-community/community-topics/ to discuss the changes.
For other changes, create a :ref:`community topic<creating_community_topic>` to discuss the changes.
(Creating a draft PR for this file and mentioning it in the community topic is also OK.)
.. _community_steering_committee:
Expand Down

0 comments on commit 83b7c12

Please sign in to comment.