Documentation

Documentation

  • Si c'est compliqué, nous pouvons essayer de le dire simplement.
  • Si un graphique peut aider, nous pouvons le créer.
  • Si une mise en page peut contribuer à faire passer un message, nous savons la trouver.
  • Si une esthétique peut agrémenter un discours sans le perturber, nous sommes des esthètes.

Nous concevons et réalisons :

  • des brochures et des plaquettes,
  • des manuels utilisateurs d'applications,
  • des guides de procédures,
  • ...

... en utilisant, selon les cas, un support papier ou numérique (web, cd-rom, fichier).

Nous aimons... Nous n'aimons pas...
  • les messages clairs, utilisant le vocabulaire des lecteurs, structurés selon leur mode de travail et leurs besoins,
  • les mises en forme qui accompagnent et renforcent les messages,
  • les outils de navigation dans les documents : sommaire, index, en-têtes et pieds de page, renvois... mais aussi les liens hypertextes...,
  • les documents maintenables, parce qu'une application ou une réglementation évoluent, parce qu'une documentation non mise à jour est abandonnée...
  • les textes écrits par et pour "ceux qui savent déjà", qu'ils soient informaticiens, juristes ou initiés quelconques,
  • les mises en formes si sophistiquées qu'elles masquent le message,
  • les documents trop longs, qui effraient le lecteur : pensez éventuellement à un support électronique, qui masque le volume du document,
  • les documents trop courts, qui confondent simplicité et simplification abusive.