docs: v2 — verified-only improvements (post-audit)

[pierrelaburthe]

Améliorations doc Logora — v2 (100 % sourcée)

Cette v2 reprend l'audit de la v1 et ne garde que ce qui est vérifié dans le code, dans les specs Swagger, ou cité verbatim dans Slack/Mail.

Tout ce qui était inventé dans la PR #9 (fermée) a été retiré. Les zones grises (SLA, IPs, durées de rétention, paramètres non vérifiables) ne sont pas écrites ici — il faudra une passe avec Henry pour les ajouter dans une v3.

Ce qui change vs la v1

Élément v1	Statut v2
faq/api.md	✅ Réécrite à partir du Swagger officiel — endpoints, scopes, params réels
faq/render-api.md (nouveau nom)	✅ Nouvelle page sourcée du Swagger render — comble un vrai trou de doc
faq/account-deletion.md	✅ Réduite aux endpoints API vérifiés — anonymize + delete + backchannel logout
installation/webview.md modifié	✅ Corrigée : vraie URL script, vrais paramètres outputType, événement logoraContentLoaded (tous sourcés Slack/code)
authentication/jwt.md modifié	✅ Corrigée : ajoute session 2h + exp checked (sources Henry verbatim)
faq/performance.md modifié	✅ Corrigée : vraie URL script (api.logora.fr/debat.js, pas cdn.logora.com)
faq/troubleshooting-sso.md	❌ Retirée — trop d'inventions (IPs, options)
faq/notification-emails.md	❌ Retirée — entièrement inventée (templates, variables, CSS)
faq/architecture-security.md	❌ Retirée — entièrement inventée (SLA, rétention, hosting, 2FA)
configuration/moderation.md réécriture	❌ Retirée — Henry doit la réécrire lui-même
configuration/onboarding.md modif	❌ Retirée — cas limites pas vérifiables sans accès au code admin
src/css/custom.css	✅ Conservée (aucune affirmation technique, juste du design)

Volume

• 3 nouveaux fichiers × 2 langues = 6 fichiers .md
• 3 fichiers modifiés × 2 langues = 6 fichiers .md
• 1 fichier CSS
• 1 sidebars.json mis à jour
• = 14 fichiers au total (vs 23 dans la v1, beaucoup plus chargés en inventions)

Sources

Chaque section pointe vers son origine. Trois types :

1. https://app.logora.fr/swagger/v1/swagger.yaml — spec OpenAPI officielle de l'API publique (10 685 lignes, 51 endpoints).
2. https://render.logora.fr/docs — Swagger UI du Render API (10 endpoints de pré-rendu).
3. Code public sous github.com/Logora/ :
   • LogoraWordpress/trunk/includes/class-logora-app-shortcode.php (paramètres logora_config)
   • LogoraWordpress/trunk/includes/class-logora-synthesis-shortcode.php (paramètres synthèse)
4. Slack verbatim : Henry sur la session JWT (#sales, 2025-08-30) ; Henry sur exp (#smf-logora-sanoma, 2025) ; Sylvia/Krone sur embed/comments (#interface, 2026-06-28) ; Jesús sur outputType workaround (#interface, 2026-05-10) ; Cronista sur outputType côté client (#cronista-logora, 2026-08-13).

Vérification

yarn install && yarn build ✅ — les deux locales (fr + en) compilent. Le seul broken-link signalé (configuration/routes.md → installation/javascript-sdk.md) est préexistant sur master et hors scope.

Ce qu'il manque (à demander à Henry pour une v3)

Pour pouvoir écrire les pages architecture-security, notification-emails, troubleshooting-sso correctement, il faut que Henry confirme :

• Hébergeur réel + région
• SLA contractuel + RTO/RPO
• Durées de rétention (IP, contributions, logs, backups)
• IPs sortantes Logora (à publier dans la doc pour les WAF clients)
• 2FA admin : obligatoire ou optionnel ?
• Liste exacte des types d'e-mails envoyés + variables disponibles dans les templates
• Sélecteurs CSS personnalisables dans les e-mails
• Existence et noms exacts de paramètres : initial_path, updateUserOnLogin, longueur min first_name, paramètre theme
• Statut de la blacklist sur pseudos (Cutowl avait demandé)
• Backchannel logout : signature attendue du logout_token, claims requis

🤖 Generated with Claude Code

[hboisgibault]

Il y a déjà une doc pour api et render-api. Pas besoin de rajouter des articles
Dans performance.md, les liens sont faux (api.logora.fr)