코멘트 및 스레드

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

GitLab은 코멘트, 스레드, 그리고 코드 제안를 통한 의사소통을 촉진합니다.

두 가지 종류의 코멘트를 사용할 수 있습니다:

코멘트에서는 마크다운을 입력하고 빠른 동작을 사용할 수 있습니다.

커밋 차이점 코멘트를 통해 코드 변경을 제안할 수 있으며, 이를 사용자가 UI를 통해 수락할 수 있습니다.

코멘트 추가 가능한 위치

다음과 같은 위치에 코멘트를 작성할 수 있습니다:

  • 커밋 차이점
  • 커밋
  • 디자인
  • 에픽
  • 이슈
  • Merge Request
  • 스니펫
  • 작업
  • OKR

각 객체마다 최대 5,000개의 코멘트를 추가할 수 있습니다.

멘션

GitLab에서는 @username 또는 @groupname과 같은 멘션을 통해 사용자나 그룹(하위 서브그룹 포함)을 언급할 수 있습니다. 언급된 모든 사용자는 할 일 항목과 이메일을 통해 알림을받습니다. 사용자는 알림 설정에서 이 설정을 자체적으로 변경할 수 있습니다.

나 자신에 대한 멘션(@username)이 포함된 코멘트는 하이라이트 표시되므로 나 자신이 언급된 코멘트를 빠르게 확인할 수 있습니다.

모든 멤버 언급

Self-Managed GitLab의 경우, 기본적으로 이 플래그가 활성화되어 있지 않습니다. 관리자는 disable_all_mention이라는 피처 플래그를 활성화할 수 있습니다. GitLab.com에서는 이 플래그가 활성화됩니다.

이 피처 플래그가 활성화되면 코멘트와 설명에 @all을 입력하면 멘션 대신 일반 텍스트가 됩니다. 이 기능을 해제하면 기존의 @all 멘션은 영향을 받지 않고 링크 상태로 유지되며, 앞으로의 @all 멘션만 일반 텍스트로 표시됩니다.

코멘트나 설명에서 @all을 언급하지 않는 것이 좋습니다. 언급하면 프로젝트, 이슈, Merge Request의 참여자뿐만 아니라 해당 프로젝트의 상위 그룹의 모든 멤버에게 알림 및 할 일 항목이 전송됩니다. 이것은 스팸으로 해석될 수 있습니다.

알림 및 멘션은 그룹 설정에서 비활성화할 수 있습니다.

이슈나 Merge Request에서 그룹 언급

코멘트에서 그룹을 언급하면 그룹의 모든 멤버가 할 일 항목을 받게 됩니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Merge Request의 경우, Code > Merge Request를 선택하고 Merge Request를 찾습니다.
  3. 이슈의 경우, Plan > 이슈를 선택하고 이슈를 찾습니다.
  4. 코멘트에서 사용자, 그룹 또는 서브그룹 네임스페이스 뒤에 @을 입력합니다. 예: @alex, @alex-team, 또는 @alex-team/marketing.
  5. 코멘트를 선택합니다.

그룹 및 서브그룹의 모든 멤버를 위해 할 일 항목이 생성됩니다.

서브그룹 멘션에 대한 자세한 내용은 서브그룹 멘션을 참조하십시오.

Merge Request 차이점에 코멘트 추가

Merge Request 차이점에 코멘트를 추가할 수 있습니다. 이러한 코멘트는 다음과 같은 경우에도 유지됩니다.

  • 리베이스 후 강제 푸시.
  • 커밋 수정.

커밋 차이점 코멘트를 추가하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Code > Merge Request를 선택하고 Merge Request를 찾습니다.
  3. Commits 탭을 선택한 다음 커밋 메시지를 선택합니다.
  4. 코멘트를 추가할 행 위로 마우스를 가져가서 행 번호 위에 떠오르는 코멘트 아이콘을 선택합니다. 여러 행을 선택하려면 코멘트 아이콘을 드래그하여 여러 행을 선택합니다.
  5. 코멘트를 입력합니다.
  6. 즉시 코멘트를 추가하려면 지금 코멘트 추가를 선택하거나 다음 키보드 단축키를 사용합니다:
    • macOS: Shift + Command + Enter
    • 다른 모든 OS: Shift + Control + Enter
  7. 리뷰를 마칠 때까지 코멘트를 게시하지 않으려면 리뷰 시작을 선택하거나 다음 키보드 단축키를 사용합니다:
    • macOS: Command + Enter
    • 다른 모든 OS: Control + Enter

이 코멘트는 Merge Request의 개요 탭에 표시됩니다.

이 코멘트는 프로젝트의 Code > 커밋 페이지에 표시되지 않습니다.

note
코멘트에 커밋에 대한 참조가 포함된 경우, 해당 컨텍스트의 Merge Request에서 링크로 변환됩니다. 예를 들어, 28719b171a056960dfdc0012b625d0b47b123196은 28719b17로 변환되며, 여기에 링크가 추가됩니다: https://gitlab.example.com/example-group/example-project/-/merge_requests/12345/diffs?commit_id=28719b171a056960dfdc0012b625d0b47b123196.

이메일을 통한 코멘트 답장

이메일로 답장 설정이 구성되어 있는 경우 이메일을 통해 코멘트에 답장을 할 수 있습니다.

  • 표준 코멘트에 답장하는 경우, 새로운 표준 코멘트가 생성됩니다.
  • 스레드 코멘트에 답장하는 경우, 스레드 내에서 답장이 생성됩니다.
  • 이슈 이메일 주소를 복사하여 이메일을 전송하는 경우 표준 코멘트가 생성됩니다.

이메일 답장에서도 마크다운과 빠른 동작을 사용할 수 있습니다.

코멘트 편집

어느 시점이든 자신의 코멘트를 편집할 수 있습니다. 최소한 Maintainer 역할을 가진 사용자는 다른 사람이 작성한 코멘트를 편집할 수 있습니다.

코멘트 편집하기:

  1. 코멘트에서 코멘트 편집을 선택합니다().
  2. 편집을 완료합니다.
  3. 변경사항 저장을 선택합니다.

멘션을 추가하기 위해 코멘트 편집

기본적으로 사용자를 멘션하면 GitLab은 해당 사용자를 위해 할 일 항목을 생성하고 알림 이메일을 보냅니다.

기존 코멘트를 편집하여 이전에 없었던 사용자 멘션을 추가하는 경우, GitLab은 다음과 같이 되어집니다:

  • 멘션된 사용자를 위해 할 일 항목을 생성함.
  • 알림 이메일을 보내지 않음.

토론을 잠그면서 댓글 방지

이슈나 Merge Request에서 공개 댓글을 방지할 수 있습니다. 이렇게 할 경우 프로젝트 멤버만 댓글을 추가하고 편집할 수 있습니다.

필수 사항:

  • Merge Request에서는 적어도 개발자 역할이 있어야 합니다.
  • 이슈에서는 적어도 기고자 역할이 있어야 합니다.

이슈나 Merge Request을 잠그려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. Merge Request의 경우 코드 > Merge Request을 선택하고 Merge Request을 찾습니다.
  3. 이슈의 경우 계획 > 이슈를 선택하고 이슈를 찾습니다.
  4. 우측 상단에서 Merge Request 작업 또는 이슈 작업 ()을 선택한 다음 토론 잠금을 선택합니다.

시스템 노트가 페이지 세부 정보에 추가됩니다.

토론이 잠긴 상태로 이슈나 Merge Request이 닫힌 경우, 토론이 잠긴 상태가 해제될 때까지 다시 열 수 없습니다.

내부 노트 추가

  • GitLab 15.0에서 “confidential comments”가 “internal notes”로 이름변경.
  • GitLab 15.0에서 GitLab.com 및 Self-Managed에서 사용 가능.
  • GitLab 15.2에서 피처 플래그 confidential_notes가 제거되었습니다.
  • GitLab 15.6에서 권한이 적어도 기고자 역할로 변경되었습니다. GitLab 15.5와 그 이전에서는 이슈나 에픽 작성자 및 담당자도 내부 노트를 읽고 생성할 수 있었습니다.
  • 메인터널 요청을 위한 내부 노트가 GitLab 16.9에서 도입되었습니다.

퍼블릭 이슈, 에픽이나 Merge Request에 내부 노트를 추가하면 해당 프로젝트 멤버만 노트를 볼 수 있습니다. 내부 노트는 일반적인 댓글로 변환할 수 없으며, 내부 노트에 대한 모든 답글도 내부 노트로 표시됩니다. 내부 노트는 공개 댓글과는 다른 색상으로 표시되며 Internal note 뱃지가 표시됩니다:

Internal notes

필수 사항:

  • 해당 프로젝트에 적어도 기고자 역할이 있어야 합니다.

내부 노트를 추가하려면:

  1. 이슈, 에픽 또는 Merge Request에서 댓글 텍스트 상자에 댓글을 입력합니다.
  2. 댓글 아래에서 이를 내부 노트로 만들기 확인란을 선택합니다.
  3. 내부 노트 추가를 선택합니다.

또한 전체 이슈를 비밀로 표시하거나 기밀 Merge Request을 만들 수도 있습니다.

댓글만 표시

많은 수의 댓글이 있는 토론에서 토론을 필터링하여 댓글이나 변경 이력(시스템 노트)만을 표시합니다. 시스템 노트에는 설명 변경, GitLab의 다른 객체에서의 언급, 레이블, 담당자 및 마일스톤에 대한 변경 사항이 포함됩니다. GitLab은 사용자의 선호도를 저장하고 사용자가 볼 수 있는 모든 이슈, Merge Request 또는 에픽에 적용합니다.

  1. Merge Request, 이슈 또는 에픽에서 개요 탭을 선택합니다.
  2. 페이지 오른쪽에서 정렬 또는 필터링 드롭다운 디렉터리에서 필터를 선택합니다:
    • 모든 활동 표시: 모든 사용자 댓글과 시스템 노트 표시
    • 댓글만 표시: 사용자 댓글만 표시
    • 이력만 표시: 활동 노트만 표시

활동 정렬 순서 변경

가장 최근 항목이 상단에 있는 활동 피드와 상호 작용하기 위해 기본 정렬 순서를 반대로 변경할 수 있습니다. GitLab은 사용자의 선호도를 로컬 리포지터리에 저장하고 사용자가 보는 모든 이슈, Merge Request 또는 에픽에 적용합니다.

활동 정렬 순서를 변경하려면:

  1. Merge Request, 이슈 또는 에픽에서 개요 탭을 엽니다.
  2. 페이지 오른쪽에서 정렬 또는 필터링 드롭다운 디렉터리에서 정렬 순서 가장 최근 항목 순 또는 가장 오래된 항목 순(기본값)을 선택합니다.

설명 변경 이력 보기

Tier: Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

설명에 대한 변경 사항을 열람할 수 있습니다.

변경 사항을 비교하려면 이전 버전과 비교를 선택합니다.

댓글 작성자에게 이슈 할당

댓글 작성자에게 이슈를 할당할 수 있습니다.

  1. 댓글에서 더보기 작업 () 메뉴를 선택합니다.
  2. 댓글 작성자에게 할당을 선택합니다: 댓글작성자에게 할당
  3. 작성자의 할당을 해지하려면 다시 버튼을 선택합니다.

일반 댓글에 회신하여 스레드 생성

일반 댓글에 회신하여 스레드를 만들 수 있습니다.

필수 사항:

  • 적어도 게스트 역할이 있어야 합니다.
  • 이슈, Merge Request 또는 에픽에 있어야 합니다. 커밋 및 스니펫에서는 스레드가 지원되지 않습니다.

댓글에 회신하여 스레드를 만들려면:

  1. 댓글의 우측 상단에서 댓글에 회신 ()을 선택합니다.

    회신 섹션이 표시됩니다.

  2. 회신을 입력합니다.
  3. 회신 또는 지금 댓글 추가 (UI의 위치에 따라 다름)를 선택합니다.

상위 댓글이 스레드로 변환됩니다.

댓글에 회신하지 않고 스레드 만들기

일반 댓글에 회신하지 않고 스레드를 만들 수 있습니다.

필수 사항:

  • 적어도 게스트 역할이 있어야 합니다.
  • 이슈, Merge Request, 커밋 또는 스니펫에 있어야 합니다.

스레드를 만들려면:

  1. 댓글을 입력합니다.
  2. 댓글의 아래에서 오른쪽으로 이동하여 댓글 옆의 아래쪽 화살표()를 선택합니다.
  3. 디렉터리에서 스레드 시작을 선택합니다.
  4. 다시 스레드 시작을 선택합니다.

스레드 만들기

스레드형 댓글이 만들어집니다.

스레드 해결

대화를 마치려면 스레드를 해결할 수 있습니다.

필수 사항:

  • 이슈나 Merge Request에 있어야 합니다.
  • 적어도 개발자 역할이 있거나 이슈 또는 Merge Request 작성자여야 합니다.

스레드를 해결하려면:

  1. 해당 스레드로 이동합니다.
  2. 다음 중 하나를 수행합니다:
    • 기존 댓글의 우측 상단에서 스레드 해결 ()를 선택합니다.
    • 마지막 회신 아래에서 회신 필드에서 스레드 해결을 선택합니다.
    • 마지막 회신 아래에서 회신 필드에서 텍스트를 입력한 다음 스레드 해결 확인란을 선택하고 지금 댓글 추가를 선택합니다.