멘션, 인용, 링크

작성한 내용을 아키텍처의 나머지 부분과 연결하는 세 가지 방법이 있습니다.

@멘션은 사람이나 팀을 지정하며, 지정된 대상은 받은편지함에서 알림을 받습니다.
#인용은 C4 요소, 결정 또는 페이지를 가리키며, 인용된 대상은 자신을 인용한 모든 곳을 보여 줍니다.
Archyl 페이지로 가는 링크는 앱과 Slack에서 미리 보기로 열립니다.

사용할 수 있는 곳

프로젝트 안에서 텍스트를 쓰는 곳이라면 어디서든 @와 #를 입력할 수 있습니다.

토론과 요소 세부 정보 패널의 댓글과 답글
아키텍처 결정 기록(ADR)의 컨텍스트, 결정, 결과
문서 페이지
변경 요청의 설명, 댓글, 리뷰

멘션

@를 입력하고 이름을 입력하기 시작하세요. 목록에는 프로젝트를 열 수 있는 사람과, 그런 사람이 한 명 이상 있는 팀이 표시됩니다. 화살표 키와 Enter로, 또는 마우스로 선택합니다.

이름이 텍스트에 입력되고, 저장하면 강조된 칩으로 표시됩니다.
멘션한 모든 사람은 받은편지함에서 알림을 받습니다: "Ada님이 결정에서 회원님을 언급했습니다", "변경 요청 #12에서" 등. 팀은 프로젝트를 열 수 있는 구성원에게 전달됩니다.
알림은 한 번만 갑니다. 텍스트를 다시 편집해도 이미 멘션된 사람에게는 알림이 가지 않습니다.
자신을 멘션해도 알림을 받지 않습니다.

제목 안의 멘션은 인식되지 않습니다. 본문에 작성하세요.

인용

#를 입력하고 입력하기 시작하세요. 목록에는 프로젝트에 담긴 항목이 표시됩니다.

시스템, 컨테이너, 컴포넌트, 코드 요소(각각 상위 요소와 함께)
결정(ADR-3처럼 제목과 함께 표시)
문서 페이지

인용은 칩이 됩니다. 칩을 클릭하면 인용된 대상이 열립니다. 요소는 다이어그램에서 해당 레벨로, 이미 선택된 상태로 열리고, 결정이나 페이지는 각자의 페이지에서 열립니다.

인용된 곳

인용할 수 있는 모든 항목은 자신이 인용된 곳을 최신순으로 보여 줍니다.

요소: 세부 정보 패널의 인용된 곳 섹션
결정: 펼친 카드의 하단
페이지: 페이지 하단

각 줄에는 인용 주변의 발췌문이 표시되며, 클릭하면 출처가 열립니다. 댓글이면 해당 토론이, 리뷰면 해당 변경 요청이 열립니다.

에이전트에서 (MCP)

MCP 서버로 연결된 에이전트도 멘션과 인용을 할 수 있습니다. 에이전트가 댓글, ADR, 문서 페이지 또는 변경 요청을 작성할 때:

@Name은 사람이나 팀을 멘션하며, 규칙과 알림은 앱에서와 같습니다. 에이전트는 list_mentionables 도구로 정확한 이름을 가져옵니다.
#Label은 요소, 결정(#ADR-3) 또는 페이지를 인용하며, 인용된 대상은 인용된 곳에 에이전트의 텍스트를 보여 줍니다.
에이전트의 댓글은 이미 토론에 참여한 사람과 해당 요소의 팔로워에게도 알림을 보냅니다.

작성할 때마다 연결된 항목이 반환되므로, 에이전트는 멘션이 올바른 사람에게 전달되었는지 확인할 수 있습니다. get_backlinks 도구는 요소, 결정 또는 페이지가 인용된 곳을 반환하므로, 에이전트는 무언가를 변경하기 전에 누가 그것을 논의하고 있는지 알 수 있습니다.

링크와 미리 보기

링크 복사

공유할 링크가 필요하면 링크 복사를 사용하세요.

요소 세부 정보 패널의 닫기 버튼 옆: 링크를 열면 해당 요소가 해당 레벨에서 선택된 상태로 열립니다.
결정 카드
문서 페이지 상단

변경 요청과 토론은 주소 표시줄에서 공유할 수 있습니다.

Archyl의 미리 보기

댓글, 변경 요청 설명 또는 리뷰에 붙여 넣은 Archyl 페이지 링크는 텍스트 아래에 카드로 표시됩니다. 카드에는 제목, 유형과 상태, 프로젝트, 발췌문이 담깁니다. 카드를 클릭하면 앱을 새로 고치지 않고 페이지가 열립니다. 메시지 하나당 최대 세 개의 링크까지 미리 보기가 표시됩니다.

미리 보기는 해당 콘텐츠가 속한 프로젝트를 열 수 있는 사람에게만 표시됩니다. 그 외의 사람에게는 일반 링크로 남습니다.

Slack의 미리 보기

Slack 봇이 설치되어 있으면 Slack에 게시된 Archyl 링크도 같은 미리 보기로 펼쳐집니다. 규칙과 설정은 Slack의 링크 미리 보기를 참고하세요.