Menciones, citas y enlaces

Tres maneras de conectar lo que escribes con el resto de tu arquitectura:

las @menciones nombran a una persona o a un equipo, a quienes se avisa en su bandeja de entrada;
las #citas apuntan a un elemento C4, una decisión o una página, que lista todo lo que la cita;
los enlaces a páginas de Archyl se abren como vista previa, en la aplicación y en Slack.

Dónde puedes usarlas

Puedes escribir @ y # en cualquier lugar de un proyecto donde se escriba texto:

comentarios y respuestas, en las discusiones y en el panel de detalles de un elemento;
el contexto, la decisión y las consecuencias de una decisión de arquitectura (ADR);
las páginas de documentación;
las descripciones de las solicitudes de cambio, sus comentarios y sus revisiones.

Menciones

Escribe @ y empieza a escribir un nombre. La lista muestra las personas que pueden abrir el proyecto y los equipos que tienen al menos una de ellas. Elige una con las flechas y Enter, o con el ratón.

El nombre se escribe en el texto y, una vez guardado, se muestra como una etiqueta resaltada.
Se avisa a cada persona que mencionas en su bandeja de entrada: "Ada te mencionó en una decisión", "en la solicitud de cambio #12", etc. Un equipo llega a sus miembros que pueden abrir el proyecto.
Se avisa a cada persona una sola vez: volver a editar el texto no avisa a quienes ya estaban mencionados.
Nunca se te avisa de tu propia mención.

Las menciones en un título no se detectan; escríbelas en el cuerpo.

Citas

Escribe # y empieza a escribir. La lista muestra lo que contiene el proyecto:

sus sistemas, contenedores, componentes y elementos de código, cada uno con su padre;
sus decisiones, listadas como ADR-3 con su título;
sus páginas de documentación.

La cita se convierte en una etiqueta. Al hacer clic en ella se abre lo que cita: un elemento se abre en el diagrama en su propio nivel, ya seleccionado; una decisión o una página se abre en su página.

Citado en

Todo lo que se puede citar lista dónde se cita, de lo más reciente a lo más antiguo:

un elemento, en la sección Citado en de su panel de detalles;
una decisión, al final de su tarjeta desplegada;
una página, al final de la página.

Cada línea muestra el extracto alrededor de la cita y abre su origen: la discusión de un comentario, la solicitud de cambio de una revisión.

Desde agentes (MCP)

Los agentes conectados a través del servidor MCP también pueden mencionar y citar. Cuando un agente escribe un comentario, un ADR, una página de documentación o una solicitud de cambio:

@Name menciona a una persona o a un equipo, con las mismas reglas y avisos que en la aplicación. El agente obtiene los nombres exactos con la herramienta list_mentionables.
#Label cita un elemento, una decisión (#ADR-3) o una página, que lista el texto del agente en Citado en.
Un comentario de un agente también avisa a las personas que ya participan en la discusión y a quienes siguen el elemento.

Cada escritura devuelve lo que se ha enlazado, para que el agente pueda comprobar que sus menciones llegaron a las personas correctas. La herramienta get_backlinks devuelve dónde se cita un elemento, una decisión o una página, lo que indica a un agente quién habla de ello antes de cambiarlo.

Enlaces y vistas previas

Copiar un enlace

Usa Copiar enlace para obtener un enlace que compartir:

en el panel de detalles de un elemento, junto al botón de cerrar: el enlace abre el elemento en su nivel, seleccionado;
en una tarjeta de decisión;
en la parte superior de una página de documentación.

Las solicitudes de cambio y las discusiones se comparten desde la barra de direcciones.

Vistas previas en Archyl

Un enlace a una página de Archyl pegado en un comentario, en la descripción de una solicitud de cambio o en una revisión se muestra como una tarjeta bajo el texto: el título, su tipo y su estado, el proyecto y un extracto. Al hacer clic en la tarjeta se abre la página sin recargar la aplicación. Se muestran como máximo tres vistas previas por mensaje.

La vista previa solo se muestra a quienes pueden abrir el proyecto al que pertenece el contenido. Para los demás, el enlace sigue siendo un enlace normal.

Vistas previas en Slack

Cuando el bot de Slack está instalado, los enlaces a Archyl publicados en Slack se despliegan en la misma vista previa. Consulta Vistas previas de enlaces en Slack para las reglas y la configuración.