60 implement visual architectural documentation diagrams as code

[MathieuMRodrigue]

Première itération pour les diagrammes demandées par Louis. Considérant que j'ai jamais vraiment fait l'APP, c'était un peu difficile de faire certains liens, donc je vais avoir besoin de vos connaissances pour améliorer tout ça.

Aussi, je me suis concentrer sur ce qui est demandé dans l'issue, si vous voulez d'autres ajouts de documentation, vous pouvez les ajouter ici.

Merci !

[lopetit]

Merci Mathieu, c'est un bon début! Je pense que ce qu'il manquerait est le lien avec le code du github. Actuellement, ça aide à comprendre à haut niveau, mais ça n'aide pas encore à naviguer entre les différents folders et scripts.
Ça prendrait un diagramme avec une boite pour chaque folder(racecar_navigation, racecar_teleop, racecar_behaviours, etc) ou package, une courte description en une ligne de ce que ça fait, des sous-boites à l'intérieur avec les noeuds/scripts et description au besoin, et des branches pour montrer les liens entre les différentes sous-boites/boites. L'idée est que ça devienne la référence pour que les étudiants comprennent où aller voir "pourquoi ça fait ça" et "comment changer ça"

Comme piste de démarrage, voici (pour l'APP5, je suis moins au courant pour le reste) une liste non exhaustive (mais presque) des scripts pertinents:
labo_brushfire.py
path_following.py
cmd_vel_arbitration.py
arduino_sensors.py
blob_detector.py
libbehaviors.py
blob_detection.launch.py
behaviors.launch.py
simulation.launch.py
slam.launch.py
rviz.launch.py
navigation.launch.py
GRO830.launch.py
dual_ekf_params.yaml

dossiers:
racecar_gazebo
racecar_navigation
racecar_behaviors
racecar_bringup
racecar_behaviors/racecar_behaviors/
racecar_navigation/resource/
racecar_bringup/racecar_bringup/

fichiers:
validation.db
map.bmp
brushfire.bmp

J'ajoute le guide étudiant si tu veux faire un ctrl-f des noms ci-dessus pour aider à comprendre les liens si nécessaire: gro830-unite5-guide-etudiant_2026.pdf

[MathieuMRodrigue]

@lopetit 2ième itération, j'ai ajouté 2 nouveaux diagrammes qui, je crois, répond à tes demandes

[lopetit]

Ça a l'air vraiment bon! Tu pourrais le linker plus haut dans la structure, genre l'afficher (ou au minimum mettre un lien) dans le readme général

[MathieuMRodrigue]

J'ai ajouté un lien sur la page principale dans la section Documentation du readme général !

[lopetit]

Je pense que ça peut encore être mis plus en avant. C'est un bon outil pour comprendre le git, donc soit mettre plus d'emphase dessus (plutôt que un lien parmis beaucoup d'items dans une liste), ou même intégrer directement les figures dans le readme principal dans une section en bas de page. Merci!