docs: améliorer rendu markdown et navigation mkdocs

- Ajouter ADR-018 (librairies Go) dans TECHNICAL.md
- Transformer Shared en menu dépliable dans mkdocs (cohérence avec autres domaines)
- Corriger listes markdown (ajout lignes vides avant listes)
- Corriger line breaks dans génération BDD (étapes "Et" sur nouvelles lignes)
- Ajouter script fix-markdown-lists.sh pour corrections futures

Impacte 86 fichiers de documentation et 164 fichiers BDD générés.

scripts/fix-markdown-lists.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+
+# Script pour ajouter des lignes vides avant les listes markdown
+# qui n'en ont pas, pour un rendu correct dans mkdocs
+
+set -e
+
+echo "🔍 Recherche des fichiers markdown dans docs/..."
+
+# Compteur de fichiers modifiés
+modified=0
+
+# Trouver tous les fichiers .md dans docs/
+find docs -name "*.md" -type f | while read -r file; do
+    echo "   Traitement de $file..."
+
+    # Utiliser awk pour ajouter une ligne vide avant les listes si nécessaire
+    awk '
+    BEGIN {
+        prev = ""
+        prev_empty = 1
+    }
+    {
+        current = $0
+        # Si la ligne courante commence par "- " et que la ligne précédente n'\''est pas vide
+        # et ne commence pas déjà par "- " (déjà dans une liste)
+        if (current ~ /^- / && prev !~ /^$/ && prev !~ /^- /) {
+            print prev
+            print ""  # Ajouter une ligne vide
+            prev = current
+        }
+        # Sinon, imprimer la ligne précédente normalement
+        else if (NR > 1) {
+            print prev
+            prev = current
+        }
+        else {
+            prev = current
+        }
+    }
+    END {
+        # Imprimer la dernière ligne
+        if (prev != "") print prev
+    }
+    ' "$file" > "$file.tmp"
+
+    # Vérifier si le fichier a changé
+    if ! cmp -s "$file" "$file.tmp"; then
+        mv "$file.tmp" "$file"
+        echo "   ✅ $file modifié"
+        modified=$((modified + 1))
+    else
+        rm "$file.tmp"
+    fi
+done
+
+echo ""
+echo "✨ Terminé ! $modified fichier(s) modifié(s)"