You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[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)
Copy file name to clipboardExpand all lines: llvm/docs/QualGroup.rst
+42-1Lines changed: 42 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -181,6 +181,46 @@ Membership Review
181
181
182
182
To ensure the group remains active and focused, member participation will be reviewed every six months. Inactive members may be removed following this review.
183
183
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
+
184
224
Current Topics & Backlog
185
225
========================
186
226
@@ -205,10 +245,11 @@ Slides used to support discussions during sync-up meetings are stored in LLVM's
0 commit comments