[llvm] [docs] Refactor QualGroup.rst: add membership rules, restructure sections (PR #157804)

via llvm-commits llvm-commits at lists.llvm.org
Wed Sep 10 02:28:12 PDT 2025 

https://github.com/uwendi updated https://github.com/llvm/llvm-project/pull/157804

>From e10042e4828c72d67e87a1638c7c729dd50a5142 Mon Sep 17 00:00:00 2001
From: "Wendi Urribarri (Woven by Toyota" <wendi.urribarri at woven-planet.global>
Date: Wed, 10 Sep 2025 16:10:19 +0900
Subject: [PATCH 1/4] Refactor QualGroup.rst: add membership rules, restructure
 sections

---
 llvm/docs/QualGroup.rst | 153 +++++++++++++++++++++++++++++++++-------
 1 file changed, 127 insertions(+), 26 deletions(-)

diff --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
index 63520cf401d3a..304bbf2210503 100644
--- a/llvm/docs/QualGroup.rst
+++ b/llvm/docs/QualGroup.rst
@@ -36,52 +36,152 @@ The Qualification Group aims to:
 The group is non-enforcing and does not control any part of the codebase.
 All technical decisions remain subject to the standard LLVM review and governance process.
 
+Group Composition
+=================
+
+Group Members
+-------------
+
+The members of the LLVM Qualification Group represent a diverse cross-section of the LLVM community, including individual contributors, researchers, vendor representatives, and experts in the field of software qualification, including reliability, quality, safety, and/or security.
+They meet the criteria for inclusion below. Knowing their handles help us keep track of who’s who across platforms, coordinate activities, and recognize contributions.
+
+.. list-table:: Group Members
+   :widths: 20 20 20 20 20
+   :header-rows: 1
+
+   * - Name
+     - Affiliation
+     - Discourse handle
+     - Discord handle
+     - GitHub handle
+   * - Alan Phipps
+     - Texas Instruments
+     - evodius96
+     - -
+     - evodius96
+   * - Carlos Andrés Ramírez
+     - Woven by Toyota
+     - CarlosAndresRamirez
+     - -
+     - CarlosAndresRamirez
+   * - Davide Cunial
+     - BMW A.G.
+     - capitan-davide
+     - capitan_davide
+     - capitan-davide
+   * - Oscar Slotosch
+     - Validas
+     - slotosch
+     - oscarslotosch_66740
+     - -
+   * - Petar Jovanovic
+     - HTECH
+     - petarj
+     - petarjovanovic_18635
+     - petar-jovanovic
+   * - Petter Berntsson
+     - Arm Limited
+     - petbernt
+     - petbernt
+     - petbernt
+   * - Wendi Urribarri
+     - Woven by Toyota
+     - uwendi
+     - uwendi
+     - uwendi
+   * - YoungJun Lee
+     - NSHC
+     - YoungJunLee
+     - YoungJunLee
+     - IamYJLee
+
+
+Organizations are limited to three representatives within the group to maintain diversity.
+
 Participation
-=============
+-------------
 
-Participation is open to anyone interested. There are several ways to get involved:
+There are several ways to participate:
 
 * Join discussions on the `LLVM Discourse <https://discourse.llvm.org/>`_ forum, under the "Community" category.
-* Engage in conversations on the LLVM Community Discord in the `#fusa-qual-wg <https://discord.com/channels/636084430946959380/1389362444169773117>`_ channel.
+* Engage in conversations on the LLVM Community Discord in the `#fusa-qual-wg <https://discord.com/channels/636084430946959380/1389362444169773117>`_ channel. Note: You need to join the community's `Discord chat server <https://llvm.org/docs/GettingInvolved.html#discord>`_ first.
 * Join our monthly sync-up calls. Details on working sessions and meeting minutes are shared on the :doc:`GettingInvolved` page.
 * Contribute ideas, feedback, or patches via GitHub, Discourse, or directly in working documents.
 
-We welcome contributors from diverse backgrounds, organizations, and experience levels.
+Contribution Principles
+-----------------------
 
-Meeting Minutes
-===============
+We understand that most members contribute in a limited capacity due to their primary responsibilities. This initiative is volunteer-driven, and we operate with the following shared principles:
 
-Meeting notes for the LLVM Qualification Working Group are published on the 
-LLVM Discourse forum. These notes provide a summary of topics discussed, 
-decisions made, and next steps. 
+* **Acknowledgement of limited bandwidth:** We recognize that no one is working full-time on this group, and participation will vary based on individual availability and priorities.
+* **Small and consistent contributions are valuable:** We believe that steady ongoing contributions, even if minimal, are crucial for long-term success, as long as there is coordination and respect for each other's time. Even small contributions (e.g., a few hours per month) can significantly advance the group's goals and have an impact. 
+* **Realistic progress expectations:** Given the voluntary nature and no full-time involvement, we expect our progress to be slow. This group was initiated in July 2025. Concrete outcomes in 1-2 years would be considered excellent for this type of cross-company and voluntary collaboration.
+* **Respect for differing capacities:** We value every member’s engagement, whether large or small, often or sporadically, as it all contributes to the overall effort. Even contributions that may seem small, such as sharing an idea or pointing out a relevant resource, are meaningful and important.
 
-You can access all minutes here:
-https://discourse.llvm.org/t/llvm-qualification-wg-sync-ups-meeting-minutes/87148
+However, we need a balance between flexibility, structure, and enough organization to move forward together. Members are expected to remain engaged through one or more of the following:
 
-Contributors
-============
+* Regular participation in meetings or asynchronous discussions.
+* Contributions to qualification artifacts, methodologies, or documentation.
+* Active involvement in at least one qualification-related task over the past year.
+
+Membership Criteria
+-------------------
+
+Membership in the LLVM Qualification Group is intended for individuals with relevant experience or active engagement in qualification-related efforts. Categories include:
+
+**Individual Contributors**
+
+  * Experience in software/tool qualification (e.g., reliability, quality, safety, security); OR  
+  * Active involvement in LLVM-related qualification efforts; OR  
+  * Significant LLVM contributions related to qualification in the past year (code, discussion, resolving related challenges).
+
+**Researchers**
+
+  * Active research, publication, or development of methodologies, frameworks, or tools aimed at improving LLVM quality and reliability.
+
+**Vendor Contacts**
 
-The LLVM Qualification Working Group is a collaborative effort involving participants 
-from across the LLVM ecosystem. These include community members and industry contributors
-with experience in compiler development, tool qualification, and functional safety.
+  * Represent organizations building or using LLVM-based tools in safety-critical environments; OR  
+  * Require involvement due to organizational role in qualification or compliance.
 
-While contributor names are recorded in the `Meeting Minutes`_ for those who attend 
-sync-up calls, we also recognize contributions made asynchronously via Discord, GitHub, 
-and other discussion channels.
+Nomination Process
+------------------
 
-All forms of constructive participation are valued and acknowledged.
+Individuals may nominate themselves or be nominated by an existing member. Nominations should:
 
-Presentation Slides
-===================
+* Explain the nominee’s background and relevance to qualification efforts.
+* Be submitted via this form: `Participant Introduction & Membership <https://forms.gle/cE1kHjqkKNtafUrD7>`_
+* Be communicated to an active LLVM Qualification Group member (e.g., on the Discord channel).
 
-Slides used to support discussions during sync-up meetings are stored in the
- `qual-wg/slides/` directory of the LLVM repository.
+Nominations are discussed within the group. If consensus is reached, the nominee is accepted. Otherwise, a majority vote will decide.
 
- Available slides:
+Membership Review
+-----------------
 
-* :download:`July 2025 <qual-wg/slides/202507_llvm_qual_wg.pdf>`
+To ensure the group remains active and focused, member participation will be reviewed every six months. Inactive members may be removed following this review.
+
+Meeting Minutes
+===============
+
+Meeting notes for the LLVM Qualification Working Group are published on the 
+LLVM Discourse forum. These notes provide a summary of topics discussed, 
+decisions made, and next steps. 
+
+Upcoming and past meeting agendas, and meeting minutes are published in a dedicated thread
+on the LLVM Discourse forum: `Meeting Agendas and Minutes <https://discourse.llvm.org/t/llvm-qualification-wg-sync-ups-meeting-minutes/87148>`_ 
+
+Slides used to support discussions during sync-up meetings are stored in LLVM's GitHub repository.
+
+Available slides:
+
+* `September 2025 <qual-wg/slides/202509_llvm_qual_wg.pdf>`_
+* `August 2025 <qual-wg/slides/202508_llvm_qual_wg.pdf>`_
+* `July 2025 <qual-wg/slides/202507_llvm_qual_wg.pdf>`_
 * (add future entries here)
 
+Note: A future patch will migrate these slide files to the `llvm-www` repository, once
+a suitable hosting location is confirmed with the community.
+
 Code of Conduct
 ===============
 
@@ -116,6 +216,7 @@ Transparency and Openness
 Unacceptable Behavior
 ---------------------
 We will not tolerate:
+
 * Harassment, discrimination, or exclusionary behavior.
 * Disruptive conduct in meetings or communication channels.
 * Using this group for marketing, lobbying, or promoting non-collaborative commercial agendas.

>From b510b6a86519c5204dd14469d1b3f702284de91a Mon Sep 17 00:00:00 2001
From: Wendi <uwendi at gmail.com>
Date: Wed, 10 Sep 2025 16:46:40 +0900
Subject: [PATCH 2/4] Correction in "Meeting Materials" section

Going back to a previous version of the text after wrong merge.
---
 llvm/docs/QualGroup.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
index 304bbf2210503..a5a47c2a52635 100644
--- a/llvm/docs/QualGroup.rst
+++ b/llvm/docs/QualGroup.rst
@@ -160,12 +160,10 @@ Membership Review
 
 To ensure the group remains active and focused, member participation will be reviewed every six months. Inactive members may be removed following this review.
 
-Meeting Minutes
-===============
+Meeting Materials
+=================
 
-Meeting notes for the LLVM Qualification Working Group are published on the 
-LLVM Discourse forum. These notes provide a summary of topics discussed, 
-decisions made, and next steps. 
+Agendas, meeting notes, and presentation slides for the sync-ups are shared to ensure transparency and continuity.
 
 Upcoming and past meeting agendas, and meeting minutes are published in a dedicated thread
 on the LLVM Discourse forum: `Meeting Agendas and Minutes <https://discourse.llvm.org/t/llvm-qualification-wg-sync-ups-meeting-minutes/87148>`_ 

>From e832018052eb1e4d14028fb9f56a10cdf10ef261 Mon Sep 17 00:00:00 2001
From: Wendi <uwendi at gmail.com>
Date: Wed, 10 Sep 2025 18:02:31 +0900
Subject: [PATCH 3/4] Update QualGroup.rst: Add Discord handle

Adding Carlos Ramirez's Discord handle
---
 llvm/docs/QualGroup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
index a5a47c2a52635..3d1ff2128df29 100644
--- a/llvm/docs/QualGroup.rst
+++ b/llvm/docs/QualGroup.rst
@@ -62,7 +62,7 @@ They meet the criteria for inclusion below. Knowing their handles help us keep t
    * - Carlos Andrés Ramírez
      - Woven by Toyota
      - CarlosAndresRamirez
-     - -
+     - carlos_andres_ramirez
      - CarlosAndresRamirez
    * - Davide Cunial
      - BMW A.G.

>From bd76e24da0158d72dcef8f6bf6ec7dcc2f84b0f3 Mon Sep 17 00:00:00 2001
From: Wendi <uwendi at gmail.com>
Date: Wed, 10 Sep 2025 18:28:02 +0900
Subject: [PATCH 4/4] Correcting handle with underscore

Escaping underscores in handle name
---
 llvm/docs/QualGroup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
index 3d1ff2128df29..b4726348e4bf2 100644
--- a/llvm/docs/QualGroup.rst
+++ b/llvm/docs/QualGroup.rst
@@ -62,7 +62,7 @@ They meet the criteria for inclusion below. Knowing their handles help us keep t
    * - Carlos Andrés Ramírez
      - Woven by Toyota
      - CarlosAndresRamirez
-     - carlos_andres_ramirez
+     - carlos\_andres\_ramirez
      - CarlosAndresRamirez
    * - Davide Cunial
      - BMW A.G.

More information about the llvm-commits mailing list