코멘트 및 스레드

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 15.1에서 도입된 페이지네이션된 병합 요청 토론 (Paginated merge request discussions)은 기본적으로 비활성화된 paginated_mr_discussions라는 플래그로 제공됩니다.
  • GitLab 15.2에서 GitLab.com에 활성화된 페이지네이션된 병합 요청 토론
  • GitLab 15.3에서 self-managed에 활성화된 페이지네이션된 병합 요청 토론
  • GitLab 15.8에서 일반 사용자에게 제공되는 페이지네이션된 병합 요청 토론. 플래그 paginated_mr_discussions가 제거됨.

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

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

  • 표준 코멘트.
  • 스레드 내의 코멘트, 이는 해결될 수 있습니다.

코멘트에서는 Markdown을 입력하고 빠른 작업을 사용할 수 있습니다.

커밋 차이에서 코드 변경을 제안할 수 있으며, 사용자는 이를 사용자 인터페이스에서 수락할 수 있습니다.

코멘트를 추가할 수 있는 위치

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

  • 커밋 차이
  • 커밋
  • 디자인
  • 에픽
  • 이슈
  • 병합 요청
  • 스니펫
  • 작업
  • OKR

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

언급

사용자나 그룹(서브그룹 언급 포함)을 GitLab 인스턴스에서 @username 또는 @groupname으로 언급할 수 있습니다. 모든 언급된 사용자는 to-do 항목과 이메일로 알림을 받습니다. 사용자는 알림 설정에서 해당 설정을 변경할 수 있습니다.

사용자가 로그인한 자신에 대한 언급은 다른 색상으로 강조되므로 자신에게 관련된 코멘트를 빠르게 확인할 수 있습니다.

모든 구성원 언급

self-managed GitLab에서는 기본적으로 이 플래그가 비활성화됩니다. 관리자는 disable_all_mention이라는 기능 플래그를 활성화하여 사용할 수 있습니다. GitLab.com에서는 이 플래그가 활성화됩니다.

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

코멘트와 설명에서 @all을 언급하는 것을 피하십시오. 이렇게 하면 프로젝트, 이슈 또는 병합 요청의 참여자뿐만 아니라 해당 프로젝트 상위 그룹의 모든 구성원에게 알림과 to-do 항목이 전달됩니다. 모든 이 사용자들은 이메일 알림과 to-do 항목을 받게 됩니다. 이는 스팸으로 해석될 수 있습니다.

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

이슈 또는 병합 요청에서 그룹 언급

코멘트에서 그룹을 언급하면 해당 그룹의 모든 구성원에게 to-do 항목이 추가됩니다.

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

그룹 및 서브그룹 구성원 전체에 대해 to-do 항목이 생성됩니다.

서브그룹 언급에 대한 자세한 정보는 서브그룹 언급을 참조하세요.

병합 요청 차이에 코멘트 추가

병합 요청 차이에 코멘트를 추가할 수 있습니다. 이러한 코멘트는 다음과 같은 경우에도 유지됩니다:

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

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 코드 > 병합 요청을 선택하여 병합 요청을 찾습니다.
  3. 커밋 탭을 선택한 후 커밋 메시지를 선택합니다.
  4. 코멘트를 추가하려는 라인을 가리키고 라인 번호 위에 커서를 놓은 후 코멘트를 선택합니다. 코멘트 아이콘을 드래그하여 여러 라인을 선택할 수 있습니다.
  5. 코멘트를 입력하고 리뷰 시작 또는 지금 코멘트 추가를 선택합니다.

코멘트는 병합 요청의 개요 탭에 표시됩니다.

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

note
코멘트에 포함된 병합 요청의 커밋에 대한 참조가 있는 경우, 해당 코멘트는 병합 요청의 맥락에서 링크로 변환됩니다. 예를 들어, 28719b171a056960dfdc0012b625d0b47b12319628719b17로 변환되며, 이는 https://gitlab.example.com/example-group/example-project/-/merge_requests/12345/diffs?commit_id=28719b171a056960dfdc0012b625d0b47b123196에 연결됩니다.

이메일로 댓글에 답장하기

만약 “이메일로 답장”을 구성했다면, 이메일을 보내어 댓글에 답장할 수 있습니다.

이메일 답장에 Markdown빠른 조치을 사용할 수 있습니다.

댓글 편집하기

당신은 언제든지 자신의 댓글을 편집할 수 있습니다. 최소한 Maintainer 역할을 가진 사용자는 다른 사람이 작성한 댓글도 편집할 수 있습니다.

댓글을 편집하려면:

  1. 댓글에서 댓글 편집 ()을 선택합니다.
  2. 편집을 수행합니다.
  3. 변경 사항 저장을 선택합니다.

멘션을 추가하려면 댓글을 편집하기

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

기존 댓글을 편집하여 이전에 없던 사용자 멘션을 추가하면 GitLab은:

  • 멘션된 사용자를 위한 할 일 항목을 생성합니다.
  • 알림 이메일을 보내지 않습니다.

논의 잠그기로 댓글 방지

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

전제 조건:

  • 머지 요청에서는 최소한 Developer 역할이 필요합니다.
  • 이슈에서는 최소한 Reporter 역할이 필요합니다.

이슈나 머지 요청을 잠그려면:

  1. 왼쪽 사이드바에서 검색 또는 이동하여 프로젝트를 찾습니다.
  2. 머지 요청의 경우 코드 > 머지 요청을 선택하고 머지 요청을 찾습니다.
  3. 이슈의 경우 계획 > 이슈를 선택하고 이슈를 찾습니다.
  4. 오른쪽 상단에서 머지 요청 작업 또는 이슈 작업 ()을 선택한 다음 논의 잠금을 선택합니다.

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

잠긴 논의가 있는 이슈나 머지 요청의 경우, 논의가 잠겨 있을 때는 재오픈할 수 없습니다.

내부 노트 추가

  • GitLab 13.9에서 confidential_notes이라는 플래그로 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 14.10에서 변경되었습니다: 이제 이슈 및 에픽에 코멘트만을 비밀로 표시할 수 있습니다. 이전에는 머지 요청 및 스니펫에 대한 코멘트도 가능했습니다.
  • GitLab 15.0에선 “비밀 코멘트”가 “내부 노트”로 이름이 변경되었습니다.
  • GitLab 15.0에서 GitLab.com 및 Self-Managed에서 사용 가능하게 되었습니다.
  • GitLab 15.2에서 기능 플래그 confidential_notes 제거되었습니다.
  • GitLab 15.6에서 권한이 변경되어 최소한 Reporter 역할이 필요합니다. GitLab 15.5 및 이전 버전에서는 이슈나 에픽 저자 및 담당자도 내부 노트를 읽거나 만들 수 있었습니다.
  • GitLab 16.9에서 머지 요청에 대한 내부 코멘트가 도입되었습니다.

공개 이슈, 에픽, 또는 머지 요청에 내부 노트를 추가하면 프로젝트 멤버 중 최소한 Reporter 역할을 가진 사용자만 해당 노트를 볼 수 있습니다. 내부 노트는 일반적인 코멘트로 변환할 수 없으며, 내부 노트에 대한 모든 답글도 내부적으로 유지됩니다. 내부 노트는 공개 코멘트와는 다른 색상으로 표시되며 내부 노트 뱃지가 표시됩니다:

내부 노트

전제 조건:

  • 프로젝트에 최소한 Reporter 역할이 필요합니다.

내부 노트를 추가하려면:

  1. 이슈, 에픽 또는 머지 요청에서 댓글 텍스트 상자에 댓글을 입력합니다.
  2. 댓글 아래에서 이를 내부 노트로 지정 확인란을 선택합니다.
  3. 내부 노트 추가를 선택합니다.

또한 전체 이슈를 비밀로 표시하거나 비밀 머지 요청을 생성할 수도 있습니다.

댓글만 표시

많은 댓글이 있는 토론에서 시스템 노트를 표시하여 댓글이나 변경 이력만 표시할 수 있습니다 (시스템 노트). 시스템 노트에는 설명에 대한 변경, 다른 GitLab 객체에서의 언급, 레이블, 담당자, 및 마일스톤에 대한 변경 사항이 포함됩니다.

GitLab은 사용자의 기본 환경 설정을 저장하고 토론하는 모든 이슈, 병합 요청, 또는 에픽에 적용합니다.

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

활동 정렬 순서 변경

기본 순서를 반대로 변경하여 활동 피드를 가장 최근 항목부터 상단에 표시합니다. GitLab은 사용자의 기본 환경 설정을 로컬 저장소에 저장하고 사용자가 보는 모든 이슈, 병합 요청, 또는 에픽에 적용합니다.

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

  1. 병합 요청, 이슈, 또는 에픽에서 개요 탭을 엽니다.
  2. 페이지 오른쪽에서 정렬 또는 필터 드롭다운 목록에서 정렬 순서 가장 최근 항목 먼저 또는 가장 오래된 항목 먼저를 선택합니다(기본값).

설명 변경 이력 보기

세부정보: Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

설명에 대한 변경 사항을 이력에 나열하여 볼 수 있습니다.

변경 사항을 비교하려면 이전 버전과 비교를 선택하세요.

이슈를 댓글 작성자에게 할당

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

  1. 댓글에서 더보기 작업 () 메뉴를 선택합니다.
  2. 댓글 달린 사용자에게 할당을 선택합니다: 댓글 달린 사용자에게 할당
  3. 댓글 작성자에 대한 할당을 취소하려면 다시 버튼을 선택합니다.

표준 댓글에 답장하여 스레드 만들기

표준 댓글에 답장하면 스레드를 생성합니다.

전제 조건:

  • 최소한 게스트 역할이 있어야 합니다.
  • 이슈, 병합 요청, 또는 에픽에 있어야 합니다. 커밋 및 코드 스니펫에 대해서는 지원되지 않습니다.

댓글에 답장하여 스레드를 생성하려면:

  1. 댓글 우측 상단에 댓글에 답장 ()를 선택합니다.

    답장 섹션이 표시됩니다.

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

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

댓글에 답장하지 않고 스레드 만들기

표준 댓글에 답장하지 않고 스레드를 만들 수 있습니다.

전제 조건:

  • 최소한 게스트 역할이 있어야 합니다.
  • 이슈, 병합 요청, 커밋, 또는 코드 스니펫에 있어야 합니다.

스레드를 만들려면:

  1. 댓글을 입력합니다.
  2. 댓글 하단에서 댓글 오른쪽에 있는 화살표()를 선택합니다.
  3. 목록에서 스레드 시작을 선택합니다.
  4. 다시 스레드 시작을 선택합니다.

스레드 만들기

스레드형 댓글이 생성됩니다.

스레드 해결

  • 이슈에 대한 해결 가능한 스레드는 기본적으로 사용하지 않도록 설정되어 있습니다. 기능 플래그에는 resolvable_issue_threads라는 이름으로 이슈31114번이 소개되었습니다. 기본적으로 사용되지 않습니다.
  • 이슈에 대한 해결 가능한 스레드는 GitLab 16.4에서 GitLab.com 및 자체 호스팅에서 사용되도록 설정되었습니다.
  • 이슈에 대한 해결 가능한 스레드는 GitLab 16.7에서 일반적으로 사용 가능합니다. 기능 플래그 resolvable_issue_threads가 제거되었습니다.

대화를 마치고 싶을 때 스레드를 해결할 수 있습니다.

전제 조건:

  • 이슈 또는 병합 요청에 있어야 합니다.
  • 최소한 개발자 역할이 있거나 이슈 또는 병합 요청 작성자여야 합니다.

스레드를 해결하려면:

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