Mentions, citations et liens

Trois façons de relier ce que vous écrivez au reste de votre architecture :

les @mentions nomment une personne ou une équipe, prévenue dans sa boîte de réception ;
les #citations pointent vers un élément C4, une décision ou une page, qui liste tout ce qui la cite ;
les liens vers des pages Archyl s'ouvrent en aperçu, dans l'application et dans Slack.

Où les utiliser

Vous pouvez taper @ et # partout où l'on écrit du texte dans un projet :

les commentaires et les réponses, dans les discussions et dans le panneau de détails d'un élément ;
le contexte, la décision et les conséquences d'une décision d'architecture (ADR) ;
les pages de documentation ;
les descriptions des demandes de changement, leurs commentaires et leurs revues.

Mentions

Tapez @ puis commencez à saisir un nom. La liste affiche les personnes qui peuvent ouvrir le projet, et les équipes qui en comptent au moins une. Choisissez avec les flèches et Enter, ou avec la souris.

Le nom est inséré dans le texte et s'affiche comme une pastille mise en évidence une fois enregistré.
Chaque personne mentionnée est prévenue dans sa boîte de réception : « Ada vous a mentionné dans une décision », « dans la demande de changement #12 », etc. Une équipe touche ses membres qui peuvent ouvrir le projet.
Les personnes sont prévenues une seule fois : modifier à nouveau le texte ne notifie pas celles déjà mentionnées.
Vous n'êtes jamais notifié de votre propre mention.

Les mentions dans un titre ne sont pas détectées ; écrivez-les dans le corps du texte.

Citations

Tapez # puis commencez à saisir. La liste affiche ce que contient le projet :

ses systèmes, conteneurs, composants et éléments de code, chacun avec son parent ;
ses décisions, listées sous la forme ADR-3 avec leur titre ;
ses pages de documentation.

La citation devient une pastille. Un clic dessus ouvre ce qu'elle cite : un élément s'ouvre dans le diagramme à son propre niveau, déjà sélectionné ; une décision ou une page s'ouvre sur sa page.

Cité dans

Tout ce qui peut être cité liste les endroits où il l'est, du plus récent au plus ancien :

un élément, dans la section Cité dans de son panneau de détails ;
une décision, en bas de sa carte dépliée ;
une page, en bas de la page.

Chaque ligne affiche l'extrait autour de la citation et ouvre sa source : la discussion d'un commentaire, la demande de changement d'une revue.

Depuis les agents (MCP)

Les agents connectés via le serveur MCP peuvent aussi mentionner et citer. Quand un agent écrit un commentaire, une ADR, une page de documentation ou une demande de changement :

@Name mentionne une personne ou une équipe, avec les mêmes règles et les mêmes notifications que dans l'application. L'agent obtient les noms exacts avec l'outil list_mentionables.
#Label cite un élément, une décision (#ADR-3) ou une page, qui liste le texte de l'agent sous Cité dans.
Un commentaire d'un agent prévient aussi les personnes déjà présentes dans la discussion et celles qui suivent l'élément.

Chaque écriture renvoie ce qui a été relié, pour que l'agent puisse vérifier que ses mentions ont atteint les bonnes personnes. L'outil get_backlinks renvoie les endroits où un élément, une décision ou une page est cité, ce qui indique à un agent qui en discute avant qu'il ne le modifie.

Liens et aperçus

Copier un lien

Utilisez Copier le lien pour obtenir un lien à partager :

dans le panneau de détails d'un élément, à côté du bouton de fermeture : le lien ouvre l'élément à son niveau, sélectionné ;
sur la carte d'une décision ;
en haut d'une page de documentation.

Les demandes de changement et les discussions se partagent depuis la barre d'adresse.

Aperçus dans Archyl

Un lien vers une page Archyl collé dans un commentaire, la description d'une demande de changement ou une revue s'affiche sous forme de carte sous le texte : le titre, son type et son statut, le projet et un extrait. Un clic sur la carte ouvre la page sans recharger l'application. Jusqu'à trois liens sont prévisualisés par message.

Un aperçu n'est affiché qu'aux personnes qui peuvent ouvrir le projet auquel appartient le contenu. Pour les autres, le lien reste un simple lien.

Aperçus dans Slack

Quand le bot Slack est installé, les liens vers Archyl publiés dans Slack se déplient dans le même aperçu. Consultez Aperçus de liens dans Slack pour les règles et la configuration.