Skip to content

Commit fde69fd

Browse files
authored
[QualGroup][docs] Document decision-taking process and refresh sync-up materials (#163122)
## Summary This PR documents the LLVM Qualification Working Group’s decision-taking process and updates the latest sync-up meeting materials. ## Changes * Added a new **Decision Taking** section describing: * Principles (consensus-first, inclusiveness, transparency)Discussion time limits * Voting procedure * Documentation of outcomes * Updated Meeting Materials with the October 2025 presentation slides. ## Background The LLVM Qualification Working Group aims to ensure decisions are made transparently and collaboratively. This new section documents how proposals are discussed, consensus is reached, and outcomes are recorded, providing clear guidance for contributors. It also keeps the group’s meeting resources up to date for easier reference and continuity. ## Testing - [x] Documentation builds successfully - [x] New “Decision Taking” section renders correctly - [x] Links and internal references are properly formatted - [x] Meeting Materials section updated with the October 2025 slides ## Related Links * [LLVM Qualification Working Group Documentation](https://llvm.org/docs/QualGroup.html)
1 parent 5f20b5a commit fde69fd

File tree

1 file changed

+42
-1
lines changed

1 file changed

+42
-1
lines changed

llvm/docs/QualGroup.rst

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,46 @@ Membership Review
181181

182182
To ensure the group remains active and focused, member participation will be reviewed every six months. Inactive members may be removed following this review.
183183

184+
Decision Taking
185+
---------------
186+
187+
The LLVM Qualification Working Group aims to make decisions transparently, collaboratively, and without unnecessary formality. The goal is to maintain efficiency while encouraging broad participation and mutual understanding.
188+
189+
This section describes the lightweight process used to handle proposals and decisions within the group. It may be revised as the group evolves and gains experience.
190+
191+
Principles
192+
^^^^^^^^^^
193+
194+
* **Consensus first:** The preferred mode of decision-making is consensus through open discussion (primarily on Discord or during sync-up meetings).
195+
* **Inclusiveness and respect:** All viewpoints are encouraged, and members are expected to contribute constructively toward reaching a shared understanding.
196+
* **Transparency:** Discussions leading to a decision should be visible to the group and, whenever appropriate, summarized in public channels (e.g., Discourse meeting notes, Discord channel, documentation updates).
197+
198+
Consensus and Time Limits
199+
^^^^^^^^^^^^^^^^^^^^^^^^^
200+
201+
Discussions remain open until a clear consensus emerges, meaning no sustained objections have been raised after reasonable discussion.
202+
203+
To prevent open-ended debates, if no new viewpoints are expressed after an agreed period (e.g., 2 weeks), the moderator (typically the person who started the discussion thread) may take one of the following actions:
204+
205+
* **Summarize the apparent consensus** and close the discussion, or
206+
* **Postpone the topic** to the next sync-up meeting if the outcome remains unclear, or
207+
* **Call for a short vote** to confirm the group’s position.
208+
209+
Voting Procedure
210+
^^^^^^^^^^^^^^^^
211+
212+
When consensus cannot be reached or when a clear yes/no decision is needed:
213+
214+
* The moderator may call for a **simple vote** using emoji reactions on Discord or a similar visible method.
215+
* A decision passes if it receives a **majority (>50%)** of votes among **participants who voted.** Non-votes are **not counted** in the total.
216+
* To ensure decisions reflect the collective position of the group, **at least three-quarters of the total core members** must participate in the vote for it to be considered valid.
217+
* If results are evenly split **(50/50)**, or if participation falls below this threshold, the topic may be postponed to the next sync-up meeting for further discussion.
218+
219+
Documentation
220+
^^^^^^^^^^^^^
221+
222+
Final decisions should be briefly documented (e.g., in meeting minutes, the corresponding GitHub issue, or Discord discussion thread). Once stable, the resulting policy or outcome may be reflected in this documentation for reference.
223+
184224
Current Topics & Backlog
185225
========================
186226

@@ -205,10 +245,11 @@ Slides used to support discussions during sync-up meetings are stored in LLVM's
205245

206246
Available slides:
207247

248+
* (add future entries here)
249+
* `October 2025 <https://docs.google.com/presentation/d/1ND2SkjgcHvcEbQmMd8ExL-PpRXouP49T-wfy3xf2yRQ/edit?usp=sharing>`_
208250
* `September 2025 <https://docs.google.com/presentation/d/1SZAE-QHfJED6CxJCCtBkPDxcw7XU9ORX54TJyXe1ppc/edit?usp=sharing>`_
209251
* `August 2025 <https://docs.google.com/presentation/d/1K8GWoRm8ZAeyyGvTeV5f-sMOhMr7WHiEk6_Nm5Fk10o/edit?usp=sharing>`_
210252
* `July 2025 <https://docs.google.com/presentation/d/1ktURe9qz5ggbdOQYK-2ISpiC18B-Y_35WvGyAnnxEpw/edit?usp=sharing>`_
211-
* (add future entries here)
212253

213254
AI Transcription Policy
214255
=======================

0 commit comments

Comments
 (0)