Journaux de bord
Les journaux gardent la trace du développement au fil de l’eau : ce qui a été fait, ce qui n’a pas marché, ce qui a été décidé et pourquoi. Le but est de pouvoir relire le cheminement de pensée, y compris les pistes abandonnées. La description du résultat final se trouve dans le reste de la documentation, pas ici.
Il y a un journal par robot.
Comment lire un journal
Chaque journal est une liste de logs, du plus récent au plus ancien. Un log a une date, un titre et une courte description. Un clic ouvre la page du log, qui détaille le sujet avec ses photos et ses vidéos.
Un log répond, quand c’est pertinent, à ces questions :
- Constat : ce qui a été fait ou observé.
- Problème : ce qui ne convenait pas.
- Décision : ce qui a été changé, et pourquoi.
- Résultat : ce que ça a donné une fois testé.
Les anciens logs ne sont pas réécrits, même si la solution a été abandonnée depuis.
Comment les journaux sont alimentés
Les notes sont envoyées par l’équipe avec un formulaire : le robot concerné, la date, le sujet, ce qui a avancé (écrit en vrac) et, si besoin, des photos, des vidéos ou des documents. Une fois par semaine, une tâche automatique relit les réponses, met chaque note au propre, compresse les médias (moins de 2 Mo par fichier) et range le tout dans le bon journal.
La procédure complète suivie par la tâche est dans docs/journaux/_sync/INSTRUCTIONS.md.