[llvm] 2b48ce7 - [docs] Add documentation for LLVM Qualification Group (#145331)

[via llvm-commits]

Author: Wendi
Date: 2025-06-27T14:23:53+01:00
New Revision: 2b48ce7034a80f02adea133793f99713e18fcb9a

URL: https://github.com/llvm/llvm-project/commit/2b48ce7034a80f02adea133793f99713e18fcb9a
DIFF: https://github.com/llvm/llvm-project/commit/2b48ce7034a80f02adea133793f99713e18fcb9a.diff

LOG: [docs] Add documentation for LLVM Qualification Group (#145331)

This patch adds a new document describing the LLVM Qualification Group,
modeled after the Security Group documentation. The goal is to create an
open working group focused on enabling LLVM use in safety-critical
applications, such as those requiring ISO 26262 qualification.

The group is intended to be non-enforcing and collaborative, and to act
as a public coordination point for contributors working on
safety-relevant concerns in LLVM.

See:
https://discourse.llvm.org/t/rfc-proposal-to-establish-a-safety-group-in-llvm/86916

In this review, I’d really appreciate your feedback on both the overall
structure and wording, especially if anything could be made clearer,
more balanced, or more aligned with LLVM’s values and documentation
tone. What feels right? What could be improved to better reflect LLVM
community expectations?

---------

Co-authored-by: Wendi Urribarri (Woven by Toyota <wendi.urribarri at woven-planet.global>

Added: 
    llvm/docs/QualGroup.rst

Modified: 
    llvm/docs/index.rst

Removed: 
    


################################################################################
diff  --git a/llvm/docs/QualGroup.rst b/llvm/docs/QualGroup.rst
new file mode 100644
index 0000000000000..ca5fe2137f47a
--- /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 (under the "Community" category): https://discourse.llvm.org/
+* Public working sessions and collaborative documents
+* [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
+====================
+
+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 
+

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
 ==================