[llvm] [docs] Add documentation for LLVM Qualification Group (PR #145331)

via llvm-commits llvm-commits at lists.llvm.org
Fri Jun 27 05:56:36 PDT 2025


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

>From e79683accc9dd702e0caa8b97591f2e8a43aeeb6 Mon Sep 17 00:00:00 2001
From: "Wendi Urribarri (Woven by Toyota" <wendi.urribarri at woven-planet.global>
Date: Mon, 23 Jun 2025 22:38:03 +0900
Subject: [PATCH 1/3] [docs] Add documentation for LLVM Qualification Group

---
 llvm/docs/QualGroup.rst | 60 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 llvm/docs/QualGroup.rst

diff --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
new file mode 100644
index 0000000000000..968e895ad1430
--- /dev/null
+++ b/llvm/docs/QualGroup.rst
@@ -0,0 +1,60 @@
+========================
+LLVM Qualification Group
+========================
+
+Introduction
+============
+
+The LLVM Qualification Group is an open working group within the LLVM community. 
+It was created to coordinate efforts around enabling the use of LLVM components 
+in safety-critical applications such as those governed by ISO 26262 (automotive), 
+DO-178C (aerospace), and EN 50128 (railways).
+
+Motivation
+==========
+
+LLVM is increasingly used in safety-critical domains (e.g., automotive, aerospace, medical),
+but currently lacks a shared structure to address the specific needs of functional safety, 
+such as systematic assurance arguments, tool qualification artifacts, and their associated 
+documentation.
+
+An more open, upstream, reusable, and collaborative approach would benefit the wider ecosystem.
+This group serves as a public forum for those interested in improving LLVM’s suitability for
+use in such environments.
+
+Goals
+=====
+
+The Qualification Group aims to:
+
+* Facilitate open discussion around tool confidence and qualification practices
+* Identify areas for upstream improvements (e.g., traceability hooks, quality evidence)
+* Share safety-relevant documentation and argumentation templates
+* Coordinate efforts across users and vendors working toward similar goals
+* Act as a point of contact for safety-related collaboration
+
+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.
+
+Participation
+=============
+
+Participation is open to anyone interested. The group currently coordinates via:
+
+* LLVM Discourse: https://discourse.llvm.org/
+* Public working sessions and collaborative documents
+* Informal discussions on the LLVM Community Discord server: https://discord.gg/xS7Z362
+* Mailing lists (as needed)
+
+Initial Contributors
+====================
+
+The initial participants include community members and industry contributors with experience
+in compiler development, tool qualification, and functional safety. (To be filled in after PR review.)
+
+Contact
+=======
+
+For more information or to get involved, please refer to the ongoing Discourse thread:
+https://discourse.llvm.org/t/rfc-proposal-to-establish-a-safety-group-in-llvm/86916 
+

>From 06ed7ab258fcc7a81371277ec48a53cbe8782502 Mon Sep 17 00:00:00 2001
From: "Wendi Urribarri (Woven by Toyota" <wendi.urribarri at woven-planet.global>
Date: Tue, 24 Jun 2025 20:51:00 +0900
Subject: [PATCH 2/3] Add QualGroup to community section in docs index

---
 llvm/docs/index.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/llvm/docs/index.rst b/llvm/docs/index.rst
index b480729aaa5d9..fe0c84569598a 100644
--- a/llvm/docs/index.rst
+++ b/llvm/docs/index.rst
@@ -86,6 +86,7 @@ LLVM welcomes contributions of all kinds. To learn more, see the following artic
    :hidden:
 
    GettingInvolved
+   QualGroup
 
 * :doc:`GettingInvolved`
 * :ref:`development-process`
@@ -97,6 +98,9 @@ LLVM welcomes contributions of all kinds. To learn more, see the following artic
 
 * :ref:`report-security-issue`
 
+* :doc:`QualGroup`  
+  LLVM Qualification Group
+
 Indices and tables
 ==================
 

>From 3b2d999d7b67addbd60216da9afc2b43b03ac530 Mon Sep 17 00:00:00 2001
From: "Wendi Urribarri (Woven by Toyota" <wendi.urribarri at woven-planet.global>
Date: Tue, 24 Jun 2025 21:03:19 +0900
Subject: [PATCH 3/3] Address review comments on QualGroup.rst

---
 llvm/docs/QualGroup.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
index 968e895ad1430..ca5fe2137f47a 100644
--- a/llvm/docs/QualGroup.rst
+++ b/llvm/docs/QualGroup.rst
@@ -41,10 +41,10 @@ Participation
 
 Participation is open to anyone interested. The group currently coordinates via:
 
-* LLVM Discourse: https://discourse.llvm.org/
+* LLVM Discourse (under the "Community" category): https://discourse.llvm.org/
 * Public working sessions and collaborative documents
-* Informal discussions on the LLVM Community Discord server: https://discord.gg/xS7Z362
-* Mailing lists (as needed)
+* [Details on working sessions will be shared soon on the GettingInvolved page]
+* Informal discussions on the LLVM Community Discord server (channel to be announced)
 
 Initial Contributors
 ====================



More information about the llvm-commits mailing list