Skip to content

Commit 63f19f1

Browse files
uwendiWendi Urribarri (Woven by Toyota
andauthored
[QualGroup] Add slides and documentation updates after July 2025 sync-up (#147196)
This patch updates the Qualification Working Group documentation with improvements based on our first sync-up meeting in July 2025: - Added July 2025 meeting slides to `qual-wg/slides/` - Updated Participation section to include clickable links to Discourse and Discord - Clarified contributor recognition to include async contributors - Added new sections for Meeting Minutes and Presentation Slides - Linked to the initial RFC and Discord channel in the Contact section - Added Code of Conduct section - Minor formatting consistency fixes across the document This change also updates `GettingInvolved.rst` to add the Qualification WG with calendar links and Discourse minutes. These updates aim to improve clarity, traceability, and contributor onboarding. --------- Co-authored-by: Wendi Urribarri (Woven by Toyota <wendi.urribarri@woven-planet.global>
1 parent 75656d8 commit 63f19f1

File tree

4 files changed

+93
-14
lines changed

4 files changed

+93
-14
lines changed

llvm/docs/GettingInvolved.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,11 @@ what to add to your calendar invite.
208208
- 3rd Tuesday of the month
209209
- `ics <https://drive.google.com/file/d/1ten-u-4yjOcCoONUtR4_AxsFxRDTUp1b/view?usp=sharing>`__
210210
- `Meeting details/agenda: <https://docs.google.com/document/d/1Glzy2JiWuysbD-HBWGUOkZqT09GJ4_Ljodr0lXD5XfQ/edit>`__
211+
* - LLVM Qualification Working Group
212+
- 1st Tuesday/Wednesday of the month
213+
- `ics <https://calendar.google.com/calendar/ical/c_fe5774fa2769c5085d6b87e8fac272e8940e7d0089bc0e0a58dc3ead7978504b%40group.calendar.google.com/public/basic.ics>`__
214+
`gcal <https://calendar.google.com/calendar/embed?src=c_fe5774fa2769c5085d6b87e8fac272e8940e7d0089bc0e0a58dc3ead7978504b%40group.calendar.google.com&ctz=Asia%2FTokyo>`__
215+
- `Minutes/docs <https://discourse.llvm.org/t/llvm-qualification-wg-sync-ups-meeting-minutes/87148>`__
211216

212217

213218
For event owners, our Discord bot also supports sending automated announcements

llvm/docs/QualGroup.rst

Lines changed: 87 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ but currently lacks a shared structure to address the specific needs of function
1818
such as systematic assurance arguments, tool qualification artifacts, and their associated
1919
documentation.
2020

21-
An more open, upstream, reusable, and collaborative approach would benefit the wider ecosystem.
21+
A more open, upstream, reusable, and collaborative approach would benefit the wider ecosystem.
2222
This group serves as a public forum for those interested in improving LLVM’s suitability for
2323
use in such environments.
2424

@@ -39,22 +39,97 @@ All technical decisions remain subject to the standard LLVM review and governanc
3939
Participation
4040
=============
4141

42-
Participation is open to anyone interested. The group currently coordinates via:
42+
Participation is open to anyone interested. There are several ways to get involved:
4343

44-
* LLVM Discourse (under the "Community" category): https://discourse.llvm.org/
45-
* Public working sessions and collaborative documents
46-
* [Details on working sessions will be shared soon on the GettingInvolved page]
47-
* Informal discussions on the LLVM Community Discord server (channel to be announced)
44+
* Join discussions on the `LLVM Discourse <https://discourse.llvm.org/>`_ forum, under the "Community" category.
45+
* Engage in conversations on the LLVM Community Discord in the `#fusa-qual-wg <https://discord.com/channels/636084430946959380/1389362444169773117>`_ channel.
46+
* Join our monthly sync-up calls. Details on working sessions and meeting minutes are shared on the :doc:`GettingInvolved` page.
47+
* Contribute ideas, feedback, or patches via GitHub, Discourse, or directly in working documents.
4848

49-
Initial Contributors
50-
====================
49+
We welcome contributors from diverse backgrounds, organizations, and experience levels.
5150

52-
The initial participants include community members and industry contributors with experience
53-
in compiler development, tool qualification, and functional safety. (To be filled in after PR review.)
51+
Meeting Minutes
52+
===============
53+
54+
Meeting notes for the LLVM Qualification Working Group are published on the
55+
LLVM Discourse forum. These notes provide a summary of topics discussed,
56+
decisions made, and next steps.
57+
58+
You can access all minutes here:
59+
https://discourse.llvm.org/t/llvm-qualification-wg-sync-ups-meeting-minutes/87148
60+
61+
Contributors
62+
============
63+
64+
The LLVM Qualification Working Group is a collaborative effort involving participants
65+
from across the LLVM ecosystem. These include community members and industry contributors
66+
with experience in compiler development, tool qualification, and functional safety.
67+
68+
While contributor names are recorded in the `Meeting Minutes`_ for those who attend
69+
sync-up calls, we also recognize contributions made asynchronously via Discord, GitHub,
70+
and other discussion channels.
71+
72+
All forms of constructive participation are valued and acknowledged.
73+
74+
Presentation Slides
75+
===================
76+
77+
Slides used to support discussions during sync-up meetings are stored in the
78+
`qual-wg/slides/` directory of the LLVM repository.
79+
80+
Available slides:
81+
82+
* :download:`July 2025 <qual-wg/slides/202507_llvm_qual_wg.pdf>`
83+
* (add future entries here)
84+
85+
Code of Conduct
86+
===============
87+
88+
We are committed to fostering a respectful, inclusive, and constructive environment
89+
where contributors from diverse backgrounds and organizations can collaborate
90+
on qualification-related efforts in the LLVM ecosystem.
91+
To support this goal, we adopt the following principles:
92+
93+
Let's Build This Together
94+
-------------------------
95+
This is a space for shared ownership and mutual learning. If you're here, you belong.
96+
Help us shape a group where trust, technical rigor, and collaboration go hand in hand.
97+
98+
Respect and Inclusion
99+
---------------------
100+
* Treat all participants with respect and dignity, regardless of background, experience level, employer, or role in the community.
101+
* Be welcoming and supportive. We value a diversity of opinions and expertise.
102+
* Assume good intent, and ask questions before drawing conclusions.
103+
104+
Constructive Collaboration
105+
--------------------------
106+
* Keep discussions focused, technical, and solution-oriented.
107+
* Provide thoughtful, actionable feedback. Avoid sarcasm, dismissive remarks, or personal criticism.
108+
* Recognize that contributors have different constraints and priorities. Seek alignment, not perfection.
109+
110+
Transparency and Openness
111+
-------------------------
112+
* Share relevant information openly to enable others to contribute effectively.
113+
* Document decisions and rationales so others can understand and build on them.
114+
* Clearly distinguish between personal opinions, organizational positions, and community consensus.
115+
116+
Unacceptable Behavior
117+
---------------------
118+
We will not tolerate:
119+
* Harassment, discrimination, or exclusionary behavior.
120+
* Disruptive conduct in meetings or communication channels.
121+
* Using this group for marketing, lobbying, or promoting non-collaborative commercial agendas.
122+
123+
Safety and Trust
124+
----------------
125+
* We aim to build qualification artifacts that others can trust. Similarly, we aim to be trustworthy collaborators.
126+
* If you see something concerning, speak up respectfully or contact the group organizer(s) privately.
127+
* We follow the LLVM Community :doc:`Code of Conduct <CodeOfConduct>`, which applies across all official LLVM communication spaces.
54128

55129
Contact
56130
=======
57131

58-
For more information or to get involved, please refer to the ongoing Discourse thread:
59-
https://discourse.llvm.org/t/rfc-proposal-to-establish-a-safety-group-in-llvm/86916
132+
For more information or to get involved:
60133

134+
* Refer to our initial `RFC: Proposal to Establish a Safety Group in LLVM <https://discourse.llvm.org/t/rfc-proposal-to-establish-a-safety-group-in-llvm/86916>`_ on the LLVM Discourse forum.
135+
* Join the conversation on the LLVM Community Discord in the `#fusa-qual-wg <https://discord.com/channels/636084430946959380/1389362444169773117>`_ channel.

llvm/docs/index.rst

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -98,8 +98,7 @@ LLVM welcomes contributions of all kinds. To learn more, see the following artic
9898

9999
* :ref:`report-security-issue`
100100

101-
* :doc:`QualGroup`
102-
LLVM Qualification Group
101+
* :doc:`QualGroup`
103102

104103
Indices and tables
105104
==================
1.32 MB
Binary file not shown.

0 commit comments

Comments
 (0)