Conventions de rédaction (extension humaine de WIKI.md)

Conventions de rédaction

Extension lisible de WIKI.md (schéma technique). Cible : humains rédacteurs (Sébastien, Mirco, futurs partenaires).

Style général

• Direct, dense, jamais condescendant.
• Présent de l'indicatif, voix active. "L'AFC autorise" et non "Il est autorisé par l'AFC que".
• Pas d'emojis dans les fiches (sauf cas explicite : pour danger, pour validé).
• Pas de smileys ni d'expressions familières (l'IA serveuse n'imite pas, elle apprend du wiki).
• Tutoiement réservé aux fiches procedure quand elles décrivent l'UX user-facing. Sinon, ton neutre.

Densité

• Une phrase = une idée.
• Pas de paragraphes > 5 lignes.
• Listes à puces dès qu'il y a 3+ items énumérables.
• Tableaux pour comparer ou structurer.

Longueur

• 60-200 lignes max par fiche.
• Si > 200 lignes : envisager split (fiche/sous-fiche.md).
• Si < 30 lignes : la fiche est probablement trop pauvre — enrichir ou fusionner.

Sourçage

• Toute affirmation chiffrée (taux, plafond, seuil, prix) DOIT pointer une source via sources-officielles entrée 'XXX' ou fiduciaire-ch-2026-full.
• Sources autorisées : AFC, AVS, OFAS, OFS, plan PME 2026, cantonal officiel, terrain validé.
• Format inline : Taux 8.1% (source : afc-tva-2024).

Liens internes

• Tout terme métier mentionné DOIT être un lien slug si la fiche existe.
• Si la fiche n'existe pas mais devrait : créer un draft plutôt que mentionner sans lien.

Frontmatter

• Toujours complet (cf. WIKI.md §1.1).
• update_count: 0 à la création, incrémenter à chaque modif.
• status: draft jusqu'à validation par sebastien ou comptable-partenaire.
• last_validated_by: "—" jusqu'à validation.

Vocabulaire suisse

• Indé, indépendant, indépendante : OK. "Travailleur indépendant" : trop lourd.
• CHF ou francs (pas "CH₣" ni "Francs Suisses").
• TVA (jamais "VAT").
• AFC (jamais "fisc fédéral" — terme français).
• Bouclement ou clôture : équivalents. Préférer "bouclement" (terme CH).
• Fiduciaire (pas "expert-comptable" — terme FR).
• Compta (familier OK), comptabilité (formel).

Ce qu'on évite

• Anglicismes non nécessaires ("workflow" → "processus", "deadline" → "échéance").
• Acronymes non expliqués au premier usage.
• Conditionnel de prudence excessive ("on pourrait éventuellement considérer que...").
• Citations sans source.
• Préambule type "Cette fiche traite de..." — entrer direct.

Exemples de bonnes vs mauvaises formulations

Cas spéciaux

Fiches marchand

• Toujours commencer par "Présomption par défaut" (pro ou privé + compte).
• Lister exceptions avec critère déclencheur.
• Section "Cas vus en production" obligatoire (vide au début, alimentée par maintainer auto).

Fiches anti-pattern

• Structure : L'erreur / Pourquoi c'est faux / Le traitement correct / Comment Luca détecte / Conséquences.
• Toujours conclure avec liens vers fiches connexes (marchand, compte).

Fiches cas-frontiere

• Structure : Règle / Seuils chiffrés / Justificatifs requis / Cas vus / Pièges.

Liens

• conventions-redaction
• glossaire
• sources-officielles