Cette semaine, je complétais la rédaction du cahier technique décrivant une tâche de codification de vidéos et je n’arrêtais pas de me demander si je comprendrais encore ma propre description de la procédure dans deux ans. C’est toute la difficulté avec la section procédure: au moment de l’écrire, quelques jours ou quelques semaines après l’avoir exécutée, elle nous semble totalement évidente. C’est difficile de se mettre dans la peau d’un lecteur pas du tout familier avec notre procédure. Dans un cahier technique, il faut vraiment inclure tous les détails pour que quelqu’un d’autre puisse répéter la procédure. Incluant la description du contexte et des accords interjuges, mon cahier de codification fait plus de 10 pages. Clairement, je ne le copierai pas tel quel dans la section Méthode des futurs articles portant sur la tâche codifiée.
Continuer la lecture de « Méthode: la procédure »