
De deux mots il faut choirir le moindre (S. Guitry)

Documenter.
Lorsque vous achetez un produit, votre premier geste est-il de vous ruer sur le manuel d’utilisation ? Généralement non ! Tester le produit tout juste déballé est plus motivant que de déchiffrer une documentation parfois rébarbative. Au pire si ça ne marche pas, ou pour éclaircir un point précis, vous daignez jeter un œil au mode d’emploi. En dernier recours.
Généralement, documenter n’est pas le premier réflexe de celui qui a trouvé l’idée géniale. Il n’est qu’à imaginer la motivation de ceux qui rédigent le mode d’emploi en police taille 4 traduit dans un anglais approximatif d’un produit made in china.
Et pourtant !
La citation de Boileau est éculée : « Ce que l’on conçoit bien s’énonce clairement, et les mots pour le dire arrivent aisément. » Pourtant cette évidence est plus actuelle que jamais malgré ses plus de 400 ans.
Documenter, c’est mettre des formes sur du fond. Les formes vont de l’orthographe à la mise en page pour attirer visuellement, pour faciliter la lecture, la lisibilité et finalement laisser place tout sa place au produit lui-même.
C’est aussi expliciter son projet et convaincre. C’est donc avant tout permettre l’échange, aussi bien avec les parties impliquées dans la conception du produit qu’avec le client potentiel.
C’est surtout structurer son idée. C’est se forcer à mettre de l’ordre dans son idée, à aller vers l’essentiel, à trouver les bons arguments et anticiper les contre-arguments. « De deux mots il faut choisir le moindre. » (Guitry).
C’est suivre un projet et donc l’évaluer au cours de son élaboration. Il s’agit donc d’un outil de supervision, de réévaluation, d’aide à la décision et à terme de profit.
C’est beaucoup transmettre, donc permettre via une base de connaissances constamment enrichie de s’appuyer sur l’expérience pour aller de l’avant.
C’est enfin prendre une option sur le futur. Ne serait-ce que pour apporter du soutien aux projets futurs s’appuyant sur les expériences tirées du projet actuel.
Je vous propose de vous aider à documenter votre projet.
Considérez-moi comme un néophyte, une personne qui ne connait rien à votre projet et que vous devez convaincre. En retour, je saurai exprimer votre idée ou votre produit sous une forme et un fond tels que tout un chacun pourra comprendre.
Avec une bonne documentation, vous démultiplierez vos talents de persuasion et donc votre succès.
Corriger.
La forme précède le fond. Lire un document truffé de fautes d'orthographe, de coquilles et à la ponctuation approximative est rébarbatif et perturbe la compréhension du fond.
Quant à la mise en page, outre l'attrait du document et l'amélioration de sa lisibilité, elle doit mettre en valeur les points clés de son contenu avec clarté.