From 4f055af3f103dfa621814c0bdbc4a103666a7d86 Mon Sep 17 00:00:00 2001
From: Serreau Jovann <jovann@siteconseil.fr>
Date: Thu, 2 Apr 2026 14:01:35 +0200
Subject: [PATCH] Add <th> headers to API doc tables, ignore css:S4662 for
 Tailwind @source directive

- Add <thead>/<th> to rate limiting and error codes tables in doc.html.twig
- Ignore SonarQube css:S4662 rule on SCSS files (Tailwind v4 @source)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 sonar-project.properties    |  3 +++
 templates/api/doc.html.twig | 10 ++++++++++
 2 files changed, 13 insertions(+)

diff --git a/sonar-project.properties b/sonar-project.properties
index b73f5c0..01b18fe 100644
--- a/sonar-project.properties
+++ b/sonar-project.properties
@@ -14,3 +14,6 @@ sonar.docker.hadolint.reportPaths=hadolint-dev.json,hadolint-prod.json
 sonar.dependencyCheck.jsonReportPath=dependency-check-report.json
 sonar.dependencyCheck.htmlReportPath=dependency-check-report.html
 sonar.cpd.exclusions=templates/pdf/**
+sonar.issue.ignore.multicriteria=e1
+sonar.issue.ignore.multicriteria.e1.ruleKey=css:S4662
+sonar.issue.ignore.multicriteria.e1.resourceKey=assets/**/*.scss
diff --git a/templates/api/doc.html.twig b/templates/api/doc.html.twig
index 62c4fb4..652bc3f 100644
--- a/templates/api/doc.html.twig
+++ b/templates/api/doc.html.twig
@@ -257,12 +257,17 @@
                         <p class="text-[10px] font-black uppercase tracking-widest text-gray-400 mb-2">{{ endpoint.extra.title }}</p>
                         <div class="border-2 border-red-200 bg-red-50 p-4">
                             <table class="w-full text-xs">
+                                <thead>
+                                    <tr><th class="py-1.5 text-left font-black uppercase text-[10px] tracking-widest text-red-800 pr-4">Code</th><th class="py-1.5 text-left font-black uppercase text-[10px] tracking-widest text-red-800">Description</th></tr>
+                                </thead>
+                                <tbody>
                                 {% for code, desc in endpoint.extra.items %}
                                 <tr class="{{ not loop.last ? 'border-b border-red-200' : '' }}">
                                     <td class="py-1.5 font-mono font-bold text-red-700 pr-4">{{ code }}</td>
                                     <td class="py-1.5 font-bold text-red-600">{{ desc }}</td>
                                 </tr>
                                 {% endfor %}
+                                </tbody>
                             </table>
                         </div>
                     </div>
@@ -297,6 +302,10 @@
                 <div class="border-2 border-gray-200 p-4">
                     <p class="text-[10px] font-black uppercase tracking-widest text-gray-400 mb-2">Headers de rate limit</p>
                     <table class="w-full text-xs">
+                        <thead>
+                            <tr><th class="py-2 text-left font-black uppercase text-[10px] tracking-widest text-gray-400">Header</th><th class="py-2 text-left font-black uppercase text-[10px] tracking-widest text-gray-400">Description</th></tr>
+                        </thead>
+                        <tbody>
                         <tr class="border-b border-gray-100">
                             <td class="py-2 font-mono font-bold text-gray-600">X-RateLimit-Limit</td>
                             <td class="py-2 font-bold text-gray-500">Nombre max de requetes par fenetre</td>
@@ -309,6 +318,7 @@
                             <td class="py-2 font-mono font-bold text-gray-600">Retry-After</td>
                             <td class="py-2 font-bold text-gray-500">Secondes avant la prochaine fenetre (si 429)</td>
                         </tr>
+                        </tbody>
                     </table>
                 </div>
             </div>