Skip to content

60 implement visual architectural documentation diagrams as code#61

Open
MathieuMRodrigue wants to merge 8 commits into
ros2from
60-implement-visual-architectural-documentation-diagrams-as-code
Open

60 implement visual architectural documentation diagrams as code#61
MathieuMRodrigue wants to merge 8 commits into
ros2from
60-implement-visual-architectural-documentation-diagrams-as-code

Conversation

@MathieuMRodrigue
Copy link
Copy Markdown
Collaborator

@MathieuMRodrigue MathieuMRodrigue commented May 22, 2026

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 !

Added a component map diagram to illustrate system architecture.
Updated system context and component map diagrams to reflect new architecture.
Updated the command flow sequence diagram to include a more complex core logic flow during autonomous operation.
@MathieuMRodrigue MathieuMRodrigue self-assigned this May 22, 2026
@MathieuMRodrigue MathieuMRodrigue added the documentation Improvements or additions to documentation label May 22, 2026
@MathieuMRodrigue MathieuMRodrigue linked an issue May 22, 2026 that may be closed by this pull request
5 tasks
@lopetit
Copy link
Copy Markdown
Collaborator

lopetit commented May 24, 2026

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement Visual Architectural Documentation (Diagrams-as-Code)

2 participants