Writing guidelines
Metadata
Dernière mise à jour le 15.04.2025 Statut linguistique : à traduire en allemand et en anglais
PDF version
En bref
L’information de cette section suffit pour la rédaction d’une première fiche. Pour les personnes plus expérimentées ou pour une information précise, le reste du document est consultable en tout temps.
- wiki·swiss respecte les 3 F : il doit être facile d’accès, facile d’utilisation et facile à comprendre. Cela nécessite notamment une information bien structurée et de manière uniforme ou la prise en compte de différents handicaps ou difficultés
- Utiliser le modèle de fiche pour rédiger votre fiche dès le départ dans la bonne structure (Guide sheet template)
- Ecrire en “je”, pas en “tu” ou “vous”. Quand cela n’est pas souhaitable, recourir à la forme impersonnelle
- Appliquer les lignes directrices FALC, notamment : utilisation de mots simples (niveau B2), phrases courtes, phrases actives plutôt que passives.
- Utiliser partout où c’est pertinent les structures “Workflow”, “Callout”, “Checkboxes” et “Tabs” (voir exemples dans section 4.2)
- Ne pas utiliser différentes polices d'écriture, ni différentes tailles de police ou d’interlignes, ni notes de bas de page
- L’utilisation de couleurs est soumise à des règles particulières
- Comme souvent, le plus simple est d’apprendre en se basant sur des exemples de fiches existantes.
Philosophie
Focus sur le Comment, pas le Quoi
L’objectif final de wiki·swiss est de permettre à la population d’exercer au mieux ses droits et de réduire sa charge administrative associée.
Pour cette raison, wiki·swiss se concentre sur le Comment ? plutôt que le Quoi ? ou le Pourquoi ?.
Dans le contexte des retraites par exemple, wiki·swiss ne cherche pas à répondre à la question “Quel est le fonctionnement du système à 3 piliers ?” mais plutôt à “Comment m’assurer que tout est OK avec mon 1er pilier ?”. Des descriptions explicatives sont bien sûr possibles, mais uniquement comme moyen pour atteindre l’objectif de fournir une marche à suivre (“How-to”).
Les trois F
Pour atteindre l’objectif final, il est nécessaire que wiki·swiss soit triplement facile : facile d’accès, facile d’utilisation et facile à comprendre.
- La facilité d’accès correspond à la facilité de trouver (i) le guide wiki.swiss et (ii) le contenu précis recherché.
- La facilité d’utilisation correspond à la facilité de s’orienter et de naviguer dans l’information mise à disposition.
- La facilité de compréhension correspond à la facilité de comprendre l’information présentée de sorte à pouvoir satisfaire son besoin informationnel.
Les trois F couvrent les trois étapes effectuées par le public-cible à la recherche d’une information :
(i) Accéder ⇒ (ii) Naviguer ⇒ (iii) Comprendre
Concrètement, cela implique les éléments suivants pour la rédaction de fiches :
Objectifs | Implications pour la mise en oeuvre |
|---|---|
Facilité d’accès |
|
Facilité d’utilisation |
|
Facilité de compréhension |
|
Le reste de ce guide présente en détails les différents éléments pertinents pour la rédaction de fiches.
Rédaction générale
Ecriture en FALC
Le texte doit être rédigé en langue facile à lire et à comprendre (FALC). Les lignes directrices complètes sont en développement. Voici une synthèse des points les plus importants dans le contexte de wiki·swiss :
Dimension | Bonnes pratiques |
|---|---|
Mots |
|
Phrases |
|
Structure |
|
Ecriture en “je”
Les textes doivent être rédigés à la 1ère personne du singulier (“je”). Quand cela n’est pas possible, il faut recourir à la forme impersonnelle.
Par exemple :
✅ “Est-ce que j’ai le droit au chômage ?”
✅ “Comment fonctionne le service militaire ?”
❌ “Comment pouvez-vous obtenir des prestations complémentaires ?”
❌ “Comment peux-tu contester une facture ?”
Pas d’écriture inclusive, mais écriture épicène simple
Les règles suivantes s’appliquent :
- Pas de formes contractées inclusives. Il faut par conséquent renoncer au point médian (·), au point (.), au tiret (-), à la parenthèse ou à la barre oblique.
- Pas d’écriture inclusive en doublets (par ex. les travailleurs et les travailleuses).
- L’écriture épicène est possible, pour autant que le texte reste aussi concis et léger que possible en ligne avec le FALC.
✅ Les “contribuables”, les “droits humains” au lieu de “droits de l’homme”
❌ “Les personnes étudiantes” au lieu de “Les étudiants”
- Le féminin générique est possible à la place du masculin générique (= toute la fiche est rédigée du point de vue d’une narratrice en je), pour autant que la mention suivante figure dans la section 1 “Dans cette fiche” : “L’utilisation du féminin est choisie pour des fins de lisibilité et inclut toute la population”
Comme le suggèrent ces règles, wiki·swiss accorde beaucoup d’importance à l’objectif d’égalité des genres sous-jacent à l’écriture inclusive. A la lumière de la recherche scientifique actuelle et des exigences FALC, wiki·swiss a néanmoins effectué une pesée d’intérêts et tranché en faveur de son objectif de compréhensibilité et simplification maximale, tout en suivant attentivement les développements en la matière.
Aspects linguistiques
En anglais
Par convention, le contenu en anglais est rédigé en anglais britannique (British English)
Cela inclut notamment:
- -ise instead of -ize (e.g. organise, not organize)
- -our instead of -or (e.g. colour, not color)
- -re instead of -er (e.g. centre, not center)
Structure générale
👉🏼 Voir Modèle de fiche pour commencer à rédiger une fiche (Guide sheet template)
Titres
(a) Niveau de titre
Il y a 4 niveaux de titre possibles :
- Le titre de la fiche, ou titre niveau 0
- Le titre niveau 1 (1)
- Le titre niveau 2 (1.1)
- Le titre niveau 3 (1.1.1)
Leur utilisation suit les règles suivantes :
- T0 et T1 sont obligatoires.
- T2 et T3 sont optionnels, à utiliser en fonction du contexte.
- T3 doit être utilisé avec parcimonie. Un nombre anormalement élevé de T3 dans une fiche peut suggérer qu’il vaudrait mieux diviser la fiche (👉 voir plus bas).
(b) Questions
Les titres de fiches doivent être formulées autant que possible comme des questions.
Par exemple pour le titre d’une fiche :
✅ “Ai-je le droit au chômage ?”
❌ “Conditions pour avoir le droit au chômage”
Pour les titres à l’intérieur de la fiche, ça dépend :
- La priorité est de les formuler de manière aussi claire et concise que possible
- Dans l’idéal, ils doivent être formulés comme des questions
- Une formulation non-interrogative mais qui serait plus claire et concise doit être privilégiée
(c) Emoticône (emoji)
Si un emoji pertinent par rapport au thème de l’article existe, il peut être utilisé en début de titre.
✅ Par ex. “⏳Pendant combien de temps ai-je droit au chômage ?”
Seulement 1 emoji par titre est admis.
❌ “⚠️ Délais de recours ⚠️”
Pour l’utilisation d’emoji dans le texte, se référer à la section "Corps de texte"
Structure de la fiche
Le tableau suivant présente la structure générique à utiliser pour chaque fiche :

Voici un exemple avec la fiche “💥Assurance responsabilité civile (RC)”

Rassembler ou diviser ?
Faut-il concentrer toutes les questions et informations sur une seule page, ou la diviser en plusieurs fiches ?
La meilleure réponse à cette question sera celle qui permettra d’atteindre au mieux les objectifs de facilité d’accès, d’utilisation et de compréhension de l’information.
Cela dépend notamment de la nature de la chose expliquée ainsi que de la quantité d’informations.
Dans l’exemple de l’assurance responsabilité civile, l’information est suffisamment simple pour tout condenser sur une seule fiche, suffisamment structurée selon les questions principales (3.1-3.6).
Dans l’exemple de l’assurance chômage, la complexité de l’information est telle qu’il a été jugée préférable de diviser l’information en fiches séparées.
Dans le cas de fiches séparées, il est important d’appliquer les 2 règles d’intégration.
- Intégration verticale : regrouper les fiches dans la même rubrique du guide (par ex: “Assurance chômage”), et avoir une page de rubrique offrant un rapide aperçu de toutes les fiches existantes
- Intégration horizontale : connecter les fiches entre elles par des liens
Hyperliens
Il faut distinguer les hyperliens internes des hyperliens externes.
S’agissant des hyperliens internes, le principe général est de connecter autant que possible les contenus existants entre eux pour faciliter l’utilisation du guide. Cela implique notamment :
- Chaque fois que notre fiche mentionne un contenu couvert par une autre fiche, un lien vers cette autre fiche doit être ajoutée
- Chaque fois que le contenu d’une autre fiche est pertinente pour compléter ou contextualiser notre fiche, un hyperlien qui y mène doit être ajouté
- Cela vaut particulièrement pour les contenus sous-divisés en plusieurs plus petites fiches (voir intégration horizontale dans section précédente).
S’agissant des hyperliens externes :
- Autant que possible, les hyperliens externes doivent être données dans la section “Pour aller plus loin” et pas dans les autres sections.
Mise en page
Médias externes
Il est techniquement possible d’intégrer les médias suivants :
- Vidéos (depuis le compte YouTube de wiki·swiss)
- Images (.jpg, .png ou .gif)
- Fichiers à télécharger
Il n’est hélas pas encore techniquement possible d’intégrer les médias suivants :
- Des fichiers son directement écoutables (en streaming)
Structuration de l’information
Les fonctionnalités pour structurer l’information sont un des principaux instruments de wiki·swiss dans son objectif de rendre l’information administrative facilement utilisable et compréhensible.
Certaines de ces fonctionnalités ne peuvent pas être utilisées dans Word ou Google Docs. Si vous souhaitez signaler leur utilisation, vous pouvez laisser un commentaire dans le document.
Voici les fonctionnalités les plus importantes, à utiliser systématiquement.
La documentation de l’hébergeur fournit des explications détaillées sur chaque fonctionnalité.
“Workflow”
Le “workflow” est l’outil-phare pour toutes les marche à suivre de wiki·swiss. Ils permettent d’expliquer un processus étape par étape. A toujours utiliser dans ces cas de figure.

“Callout”
Encadré à utiliser pour ajouter une information, rendre attentif à un élément important, etc.
A utiliser avec modération.

Listes avec cases à cocher (“checkboxes”)
A utiliser chaque fois que des conditions à remplir sont listées.
Par souci d’uniformité, wiki·swiss a décidé d’appliquer la convention suivante :
- Les cases sont déjà cochées, pour signifier que la condition doit être remplie
- Le texte doit être remis en noir au lieu de gris, pour davantage de lisibilité

“Tabs”
Chaque “Tab” doit être numéroté avec les emojis 1️⃣-9️⃣.
Une contrainte : le texte en titre du “Tab” doit être très court (1-3 mots). Sinon, utiliser un autre procédé (“Callout”, sous-fiche, etc.)

Voici d’autres fonctionnalités utiles :
- “Vertical Split” : utile pour comparer deux situations ou régimes
- Les tableaux : ⚠️ max 5 colonnes pour 1 tableau (en raison de la lecture sur smartphone)
- Les listes à puces et listes numérotées traditionnelles
La documentation de l’hébergeur fournit des explications détaillées sur chaque fonctionnalité.
Corps de texte
Les opérations de mise en page suivantes ne sont techniquement pas possibles. Il ne faut donc pas les utiliser.
- Changer la police d’écriture
- Changer la taille de la police d’écriture
- Interlignes particuliers ou variables
- Notes de bas de page ou de fin de document
- Exposants ou indices
- Infobulles (tooltips)
Les opérations de mise en page suivantes sont techniquement possibles :
- Gras
- Italique
- Surligné
- Barré
- Utilisation d’émoticônes (emoji) ⚠️
- Couleur de police d’écriture ⚠️
- Surlignage du texte en couleur ⚠️
Les opérations marquées avec un ⚠️ font l’objet de règles particulières.
⚠️ Utilisation d’émoticônes
- Les emojis 0️⃣-9️⃣ et 🅰️ &🅱️sont à utiliser uniquement dans les situations décrites plus haut.
- Des emojis utiles et conseillés sont notamment ⚠️💡👉🏼✅❌🔴🟡🟢📞📧📨📮🔎
- Pas d’informalité. Les 😉, 😂, 😘 et autres 🙃 sont à proscrire. C’est clair ? 😜
- En général, les emojis doivent être utilisés avec prudence et modération
⚠️ Couleur de police d’écriture & Surlignage du texte en couleur
- Le texte peut être écrit dans un ton de gris plus clair que le noir pour indiquer qu’il s’agit d’une information secondaire (par ex. une note sous une image). Cela peut être utile puisqu’il n’est pas possible de modifier la taille de la police
- Autrement, le surlignage est à préférer au changement de couleur de police
- De manière générale, il est conseillé d’utiliser les couleurs avec modération en raison des défis qu’elles posent:
- Avantage : des “codes couleurs” peuvent aider à structurer l’information
- Défi : peut complexifier l’information plutôt que la simplifier si trop de couleurs sont utilisées (4+)
- Défi : les couleurs doivent être lisibles en mode clair ou en mode sombre sur le navigateur
- Défi : selon la norme WCAG 2.2, le contraste des couleurs doit être supérieur à 4.5:1 pour que le texte soit lisible par des personnes souffrant de handicaps visuels
Typography
👉 For writing visual aspects, refer to the guide Typography.