Skip to content

Styleguide

Jump to bottom
Matti Schneider edited this page Nov 1, 2022 · 15 revisions

Product name

Common to all languages

  • The name of the product is “Open Terms Archive”.
  • Open Terms Archive is a brand name, not a common noun. It does not have a determiner.
  • It is singular. It is not “Open Terms Archives”.
  • It has spaces. It is not “OpenTermsArchive”.
  • As often as possible, non-breakable spaces should be used to separate the three words, in order to avoid line breaks in the middle of the name.
  • While the “OTA” abbreviation can be used in internal documents and discussions, it is not used publicly (at least not by us).

English examples

- OTA enables activists to identify misleading terms.
- The Open Terms Archive enables activists to identify misleading terms.
- OpenTermsArchive enables activists to identify misleading terms.
+ Open Terms Archive enables activists to identify misleading terms.

Exemples en français

  • Open Terms Archive est un nom féminin, car il s'agit de l'archive, la base de données.
- OTA permet aux parlementaires de suivre l'application de leurs lois.
- L’Open Terms Archive permet aux parlementaires de suivre l'application de leurs lois.
- OpenTermsArchive permet aux parlementaires de suivre l'application de leurs lois.
+ Open Terms Archive permet aux parlementaires de suivre l'application de leurs lois.

Habillage des courriels

Utilisation des différents layouts

Les emails transactionnels et les formulaires utilisent un layout « blanc » et les contenus écrits par des humains (par exemple les Mémos ou les invitations aux démos) utilisent un layout « noir ».

Cohérence des styles

Pour faciliter la cohérence des styles des campagnes emails, il faut toujours dupliquer le brouillon disponible correspondant au type de mail que vous souhaitez envoyer. Pensez à reporter les évolutions apportées au template sur le brouillon correspondant et dans toutes les langues.

Redaction des mémos

Format

  • Titre
  • Service · Document · Date de modification
  • Corps du texte
    • Description des changements au passé composé (par exemple « a ajouté », « a retiré »…).
    • Lien systématique vers le diff sur le verbe d’action. Titre du lien : « Voir le changement ». On évite les verbes « annoncer » et équivalents, car la plupart du temps les changements détectés ne sont justement pas annoncés.
    • Citations bienvenues, mais on essaie de minimiser leur longueur car le texte juridique est souvent très verbeux.
    • Mettre en gras le point le plus important.
    • Ne pas mettre les citations en italique.
    • Pour la version anglaise, chercher les citations dans la version originale.
  • Contextualisation (optionnel)
    • Corps du texte dans un nouveau paragraphe : contextualisation avec liens externes, vers les sources les plus autoritatives possible.

Tweets

Langue

  • Si le changement concerne un document en anglais, tweeter en anglais et en français.
  • Si le changement concerne un document en français, tweeter en français uniquement.
  • Veiller au bon emploi des guillemets. En anglais, les guillemets sont “” (sans espace) en anglais et « » en français (avec espace insécable).

Format

${emoji} ${description}
${lien vers le changement}
#TermsSpotting ${autres hashtags spécifiques}
${capture d'écran du changement}
  • Ouvrir le message par un emoji en rapport avec le changement détecté.
    • Si le tweet est écrit dans les deux langues, mettre le même émoji pour les deux.
  • Décrire le changement de manière neutre et objective, sans jugement.
  • Utiliser le nom du service accompagné d’un #.
  • Insérer le lien vers le changement présenté après un retour de ligne. Si le changement est conséquent, copier le lien depuis la balise latérale au niveau du changement visible dans l’illustration.
  • Favoriser la vue rich diff de GitHub pour la capture d’écran servant à illustrer le changement.
    • Pour une meilleure visibilité, agrandir le texte ou réduire la fenêtre avant de faire la capture d’écran. Cela permettra de circonscrire la largeur de l’image.
  • Après un retour de ligne, conclure le tweet par #TermsSpotting.
  • Ne pas hésiter à apporter du contexte au changement présenté avec le renvoi vers un article de presse en ligne si la situation le permet, de préférence dans un tweet en réponse au premier.

Visibilité

  • Si le changement détecté est susceptible de concerner une communauté d’utilisateurs actifs sur Twitter, veiller à employer des hashtags utilisés par ladite communauté.
  • Si le changement est susceptible d’être repris et partagé par des personnalités publiques, des organisations de la société civile ou des médias, identifier les comptes dans l’image d'illustration. S’il est impossible d'identifier certains comptes, les mentionner en réponse au tweet.
  • Lorsque le changement présenté fait écho à une décision de justice, à celle d’une autorité administrative indépendante ou celle d’une organisation internationale, identifier le compte de la structure l’origine de la poursuite.
Clone this wiki locally