..
   # *******************************************************************************
   # Copyright (c) 2026 Contributors to the Eclipse Foundation
   #
   # See the NOTICE file(s) distributed with this work for additional
   # information regarding copyright ownership.
   #
   # This program and the accompanying materials are made available under the
   # terms of the Apache License Version 2.0 which is available at
   # https://www.apache.org/licenses/LICENSE-2.0
   #
   # SPDX-License-Identifier: Apache-2.0
   # *******************************************************************************

Quality Reports
===============

.. include:: quality_links.rst

Nightly quality job results are built and published to GitHub Pages after each
nightly run of the `Nightly Quality Jobs`_ workflow.

.. list-table::
   :widths: 20 45 35
   :header-rows: 1

   * - Job
     - Description
     - Report
   * - Coverage
     - Line, function, and branch coverage from C++ unit tests (gcov/lcov)
     - |coverage_report_link|
   * - Clang-Tidy
     - Static analysis findings (errors and warnings) across all C++ targets
     - |clang_tidy_report_link|
   * - CodeQL
     - MISRA C++ compliance findings via CodeQL (codeql/misra-cpp-coding-standards).
       Analyzed for both the Linux and QNX (``--config=qnx``) builds; the published
       findings are the **deduplicated union** of both configs.
     - | |codeql_report_link|
       | |codeql_integrity_report_link|
       | |codeql_deviations_report_link|
       | |codeql_compliance_report_link|
       | |codeql_recat_report_link|

|quality_dashboard_link|

.. note::

   Quality reports are generated by the nightly CI job and published
   exclusively alongside the ``latest`` documentation on GitHub Pages.
   In local Sphinx builds the link cells above show equivalent ``bazel run``
   commands. In versioned release docs, every quality link (coverage,
   dashboard, clang-tidy, and CodeQL) points to the corresponding report
   uploaded as a release artifact for that release.

.. _Nightly Quality Jobs: https://github.com/eclipse-score/communication/actions/workflows/nightly_quality.yml