Commentaires

Les commentaires vous permettent de discuter directement sur les composants de votre architecture. Plutot que d'echanger par email ou Slack avec des captures d'ecran, commentez directement sur le node concerne. Le contexte est preserve et la discussion reste attachee a l'element.

Ajouter un commentaire#

Sur un node specifique#

La methode la plus courante :

1. Selectionnez un node sur le canvas
2. Ouvrez l'onglet Commentaires dans le panneau de droite
3. Redigez votre commentaire dans la zone de texte
4. Cliquez sur Envoyer

Le commentaire est lie au node selectionne. Quand quelqu'un clique sur la notification, il arrive directement sur ce node.

Panneau de commentaires avec threads

Commentaire general#

Pour un commentaire qui ne concerne pas un node specifique :

1. Deselectionnez tout (cliquez sur une zone vide du canvas)
2. Ouvrez l'onglet Commentaires
3. Ajoutez votre commentaire

Les commentaires generaux concernent le projet dans son ensemble.

Via le popover#

Quand vous survolez un node, un bouton de commentaire apparait. Cliquez dessus pour ouvrir directement le panneau de commentaires filtre sur ce node.

Popover de commentaire sur un node

Threads de discussion#

Les commentaires supportent les reponses pour creer des discussions structurees :

Repondre a un commentaire#

1. Cliquez sur Repondre sous un commentaire
2. Redigez votre reponse
3. Envoyez

Les reponses sont indentees sous le commentaire parent pour une lecture claire.

Repondre a une reponse#

Vous pouvez repondre a n'importe quel niveau. La zone de reponse pre-remplit automatiquement une @mention de l'auteur du message auquel vous repondez.

@Mentions#

Mentionnez un collegue pour attirer son attention :

Comment mentionner#

1. Dans votre commentaire, tapez @
2. Une liste des membres du projet apparait
3. Continuez a taper pour filtrer
4. Selectionnez le membre (clic ou Entree)
5. Continuez votre message

Exemple : @alice Peux-tu valider cette architecture de cache ?

Notification#

Le membre mentionne recoit :

• Une notification in-app instantanee (cloche dans la sidebar)
• Un email (selon ses preferences de notification)

La notification inclut un lien direct vers le commentaire avec deep linking.

Reactions#

Reagissez rapidement aux commentaires avec des emojis :

1. Survolez un commentaire
2. Cliquez sur l'icone de reaction (smiley)
3. Selectionnez un emoji

Les reactions sont comptabilisees et affichees sous le commentaire. Utile pour :

• Marquer un accord (👍)
• Signaler une validation (✅)
• Indiquer une question vue (👀)
• Celebrer une bonne idee (🎉)

Filtrage#

Le panneau de commentaires offre des options de filtrage :

Par node#

Quand un node est selectionne, le panneau affiche uniquement les commentaires lies a ce node. Le badge dans l'onglet indique le nombre de commentaires.

Deselectionnez le node pour voir tous les commentaires du projet.

Commentaires resolus#

Toggle Afficher les resolus pour inclure ou exclure les discussions terminees.

Resoudre un commentaire#

Quand une discussion est terminee :

1. Cliquez sur Resoudre (coche) sur le commentaire
2. Le commentaire passe en mode resolu (grise)
3. Il est masque par defaut (sauf si le toggle est actif)

Vous pouvez rouvrir un commentaire resolu si necessaire.

Synchronisation temps reel#

Les commentaires se synchronisent en temps reel via SSE (Server-Sent Events) :

Indicateur de connexion#

Une icone Wifi dans le header indique l'etat de la connexion :

• Vert : Connecte, synchronisation active
• Orange : Reconnexion en cours
• Rouge : Deconnecte

Mises a jour instantanees#

Quand vous etes connecte :

• Les nouveaux commentaires apparaissent instantanement
• Les reactions se mettent a jour en temps reel
• Les resolutions sont synchronisees

Reconnexion automatique#

En cas de deconnexion (perte reseau, mise en veille), le systeme se reconnecte automatiquement et synchronise les changements manques.

Deep linking#

Le deep linking vous amene directement au contexte d'un commentaire :

Quand vous cliquez sur une notification :

1. Le projet s'ouvre (si vous n'y etes pas)
2. Le canvas scroll vers le node concerne
3. Le node est automatiquement selectionne
4. Le panneau Commentaires s'ouvre
5. Le commentaire est mis en surbrillance

Cette navigation contextuelle evite de chercher ou se situe la discussion.

Bonnes pratiques#

Commentaires efficaces#

Quelques conseils pour des discussions productives :

• Soyez specifiques : Mentionnez le node concerne, meme si vous y etes deja
• Utilisez les @mentions : Attirez l'attention des bonnes personnes
• Posez des questions claires : Concluez par une question si vous attendez une reponse
• Un sujet par commentaire : Gardez les discussions focalisees

Organisation#

• Un commentaire = un sujet
• Utilisez les reponses pour les discussions
• Resolvez les commentaires traites
• Nettoyez periodiquement les discussions obsoletes

Pour les revues#

Lors d'une revue d'architecture :

1. Le reviewer commente sur chaque point
2. L'auteur repond ou effectue les modifications
3. Le reviewer valide avec une reaction ou un "Merci, resolu"
4. Le commentaire est resolu

Permissions#

Les Viewers peuvent ajouter des commentaires mais ne peuvent resoudre que ceux qu'ils ont crees.

Prochaines etapes#

• Notifications pour configurer les alertes
• Equipes pour organiser les membres
• Canvas pour les interactions sur le diagramme