CodeStream에 대한 피드백 요청

New Relic CodeStream의 피드백 요청은 기존의 주기 종료 코드 검토에 사용할 수 있을 만큼 강력하지만 동시에 매우 쉽고 유연하여 개발 프로세스 전반에 걸쳐 이를 사용하여 작업에 대한 빠른 피드백을 얻을 수 있습니다. 진전. 커밋되지 않은 변경 사항에 대한 피드백 요청을 사용할 수도 있습니다.

기존 코드 검토는 변경 사항을 병합하려는 개발 주기의 마지막에 발생합니다. 주기 종료 코드 검토는 팀원들에게 훨씬 더 부담이 될 뿐만 아니라 게임 후반부에 문제를 식별할 위험이 있어 결국 일정을 지연시킬 것인지 아니면 기술적인 부채를 떠안을 것인지 결정해야 합니다.

일부 기능만 제거된 프로젝트 시작 단계에 있거나 진행 중인 작업의 중간 단계에 있거나 완료된 프로젝트에 대한 최종 검토 준비가 되어 있는지 여부에 관계없이 CodeStream은 개발 주기 중 어느 시점에서든 피드백을 가능하게 합니다. . CodeStream은 푸시된 커밋, 로컬 커밋, 준비 및 저장된 변경 사항을 포함하여 현재 상태를 공유하는 복잡성을 처리합니다. 팀원들은 애플리케이션을 전환하거나 분기를 전환하거나 변경 사항을 가져올 필요 없이 IDE에서 피드백을 제공할 수 있습니다.

개발 주기가 끝날 때 공식 코드 검토/풀 요청에 도달할 때까지는 문제가 계속 제기되고, 논의되고, 해결되었기 때문에 훨씬 덜 고통스럽고 형식적입니다.

CodeStream을 사용하여 IDE 내에서 피드백을 요청하는 방법을 보려면 이 짧은 YouTube 동영상(4분 25초)을 시청하십시오.

피드백 요청 UI

New Relic CodeStream의 피드백 요청 섹션에는 귀하에게 할당되었거나 귀하가 요청한 모든 공개 피드백 요청은 물론 승인되었거나 변경이 요청된 최근 피드백 요청이 나열됩니다.

피드백 요청을 클릭하면 바로 들어가서 검토를 시작하거나 작업에 대한 팀원의 의견을 볼 수 있습니다.

피드백 요청

피드백을 요청하려면:

• CodeStream 창 상단에서 + 만들기 버튼을 클릭합니다.
• 피드백 요청 섹션의 헤더에서 + 피드백 요청 버튼을 선택합니다. 관리자인 경우 피드백 요청 할당 과 승인이 조직에서 작동하는 방식을 제어하는 톱니바퀴 아이콘도 표시됩니다.
• 키보드 단축키(Mac의 경우 ctlr+shift+/ r 또는 ctrl+/ r )를 사용할 수도 있습니다.

클릭 한 번으로 마지막 커밋 메시지, 지점 이름 또는 티켓을 선택하여 작업을 시작한 경우 티켓 제목을 기반으로 피드백 요청의 이름을 지정할 수 있습니다. CodeStream은 현재 편집기에서 선택한 파일의 리포지토리/분기 변경 사항에 대한 피드백을 요청한다고 가정합니다. IDE에 여러 리포지토리가 열려 있는 경우 피드백 요청 양식 맨 위에 있는 리포지토리 드롭다운을 통해 이를 변경할 수 있습니다.

조직의 피드백 요청 설정에 따라 CodeStream은 특정 검토자를 제안할 수 있습니다. 변경되는 코드의 커밋 기록을 기반으로 제안에는 아직 CodeStream 팀에 없는 사람이 포함될 수도 있습니다. 이 경우 이메일로 알림을 받게 됩니다. 리뷰어의 이름 위로 마우스를 가져가면 자세한 내용을 보거나 제거할 수 있습니다. 여러 검토자가 할당된 경우 검토를 승인할 수 있는 사람이 있는지 또는 각 검토자가 개별적으로 승인해야 하는지 여부를 결정할 수도 있습니다. 피드백 설정을 구성하는 방법 에 대해 자세히 알아보세요.

풀 리퀘스트에서 변경된 파일 탐색

변경된 파일 섹션에는 추가, 제거 또는 수정된 모든 파일이 나열됩니다. 피드백 요청을 제출하기 전에 변경 사항을 검토하려면 파일을 클릭하여 차이점을 확인하세요.

체크인된 바이너리 파일과 같이 검토에 적합하지 않은 파일이 있는 경우 파일 위에 마우스를 놓고 x 를 클릭하여 피드백 요청에서 해당 파일을 제외할 수 있습니다. 해당 파일은 양식 아래의 목록으로 이동됩니다. 새 파일은 기본적으로 피드백 요청에서 제외되지만 목록에서 항목 위로 마우스를 가져간 다음 + 를 클릭하여 추가할 수 있습니다.

제외된 파일 위로 마우스를 이동하고 휴지통을 클릭하여 향후 모든 피드백 요청에서 영구적으로 제외합니다. 파일을 영구적으로 제외하면 저장소에 .codestreamignore 파일이 생성됩니다. 팀원도 이러한 파일(예: package-lock.json 또는 기타 시스템 생성 파일)을 제외하고 싶어할 것이라고 생각되면 파일을 커밋하고 푸시하여 팀원도 사용할 수 있도록 할 수 있습니다.

선택한 파일에 표시되는 변경 사항은 4가지 범주로 구분되어 피드백 요청에 포함할 항목을 정확히 선택할 수 있습니다. 여기에는 푸시되지 않았거나 커밋되지 않은 변경 사항이 포함됩니다.

네 가지 범주는 다음과 같습니다.

• 저장된 변경 사항
• 단계적 변경
• 로컬 커밋
• 푸시된 커밋

풀 리퀘스트 커밋

커밋은 로컬 커밋 및 푸시된 커밋 섹션에서 내림차순으로 나열됩니다. 커밋에 대한 확인란을 선택 취소하면 이전 커밋에 대한 모든 확인란이 자동으로 선택 취소됩니다. 즉, 피드백 요청에 포함된 커밋은 연속적이어야 합니다. 기본적으로 커밋만 확인되지만 검토에 포함할 수 있습니다.

선택적으로 피드백 요청을 Slack 또는 Microsoft Teams에 공유할 수 있습니다.

피드백 요청을 제출하면 팀원들에게 활동 피드를 통해 알림이 전송되며 검토자로 지정된 모든 사람은 @멘션되어 이메일 알림을 받게 됩니다.

피드백 요청 설정

기본적으로 피드백을 요청하는 사람이 승인 작동 방식을 결정할 수 있지만 조직의 모든 피드백 요청에 대한 기본 동작을 설정할 수도 있습니다.

• 할당된 검토자 수에 관계없이 모든 검토자가 을(를) 승인할 수 있습니다 .
• 모든 검토자는 승인된 것으로 간주되기 전에 개별적 으로 승인해야 합니다.
• 검토를 요청한 개발자는 요청을 승인하기로 결정 합니다.

CodeStream이 검토자를 제안할지 여부와 방법을 결정할 수도 있습니다.

• 라운드 로빈 은 조직의 모든 개발자를 순환합니다.
• Random 은 조직의 모든 개발자에게 피드백 요청을 무작위로 할당합니다.
• Authorship 옵션은 변경 사항의 영향을 받는 코드 라인을 작성한 개발자와 해당 분기에 커밋했을 수 있는 다른 개발자를 기준으로 최대 3명의 검토자를 제안합니다.

피드백을 제공하다

CodeStream의 피드백 요청의 가장 좋은 점은 팀원이 코드를 살펴보게 해도 팀원에게 추가 부담이 되지 않는다는 것입니다. 분기를 전환하거나 변경 사항을 가져오기 위해 자신의 작업을 따로 설정할 필요가 없으며 IDE를 떠날 필요도 없습니다. 적절한 저장소가 있는 한 피드백 요청을 열고 변경 사항 검토를 시작할 수 있습니다.

변경된 파일 섹션에서 아무 파일이나 클릭하여 변경 사항을 검토하십시오. 변경 사항은 편집기에 diff와 함께 표시됩니다. IDE의 기본 탐색을 사용하여 파일의 변경 사항을 단계별로 살펴보거나 IDE 상단의 위쪽/아래쪽 화살표를 클릭할 수 있습니다. JetBrains IDE의 경우 CodeStream은 side-by-side diff 뷰어만 지원합니다.

일반적으로 diff는 기능 분기가 생성된 지점에서 기본 분기에 대한 피드백 요청(예: 기능/주제 분기)과 관련된 분기의 변경 사항을 나타냅니다. CodeStream diff를 사용하면 개발자가 피드백 요청에 변경 사항을 모두 포함하지 않았을 수 있으므로 항상 그런 것은 아닙니다. 결과적으로 변경 사항이 비교되는 파일 버전에는 실제로 기본 분기에 없는 변경 사항도 포함될 수 있습니다. 이것은 연속성을 제공하기 위해 중요합니다.

의견 및 변경 요청

변경 사항에 대한 일반적인 의견이 있는 경우 피드백 요청의 스레드에 응답을 추가하세요 .

• 실제 변경 사항에 대해 주석을 추가하려면 diff 오른쪽에서 일부 코드를 선택한 다음 선택 항목 옆에 있는 CodeStream 창에 나타나는 주석 버튼을 클릭하십시오.
• 일부 코드를 선택한 후 키보드 단축키(Mac의 경우 ctlr+shift+/ c 또는 ctrl+/ c )를 사용할 수도 있습니다.

전체 파일 컨텍스트가 있으므로 변경된 코드 줄에만 주석을 추가하는 것으로 제한되지 않습니다. 예를 들어, 작업이 필요하거나 단순히 참조하려는 파일의 다른 부분을 발견할 수 있습니다.

일반적인 주석이든 코드에 대한 주석이든 관계없이 변경 요청으로 표시하여 개발자에게 변경 사항을 승인하기 전에 필수임을 알릴 수 있습니다.

피드백을 제공하는 동안 변경 집합의 일부가 아닌 파일에 댓글을 달 수 있으며 검토에 대한 응답으로 추가됩니다. 이것은 개선이 필요할 수 있는 코드베이스의 다른 위치를 팀원에게 지시할 수 있는 데 도움이 됩니다.

변경 요청 승인

피드백 요청과 관련된 모든 변경 요청은 토론 스레드의 일부인 것 외에도 상단의 섹션에 요약되어 있습니다. 작업이 완료되면 완료로 표시됩니다.

• 변경 사항을 승인하거나 추가 변경 사항을 요청하려면 상단의 녹색 및 빨간색 버튼을 찾으십시오.
• 열려 있는 변경 요청이 있는 경우 승인 버튼이 번호를 표시하는 파란색 버튼으로 대체됩니다. 여전히 변경 사항을 승인할 수 있지만 처리되지 않은 작업을 알고 있습니다.
• 여러 검토자가 있고 각 검토자의 승인이 필요한 경우 CodeStream은 아직 미결 승인이 있는 경우 이를 매우 명확하게 표시합니다. 오른쪽 상단의 파란색 버튼은 미결 승인 수를 보여줍니다. 검토자의 얼굴에 있는 녹색 엄지손가락은 검토자가 이미 변경 사항을 승인했음을 나타냅니다.

더 많은 코드 변경 사항 추가

일반적인 워크플로에는 검토자가 몇 가지 의견을 남기거나 몇 가지 변경 사항을 제안한 다음 개발자가 코드를 더 많이 변경하여 해당 피드백에 응답하는 작업이 포함됩니다. 프로세스를 계속하려면 파란색 수정 버튼을 클릭하여 변경 사항을 추가하십시오.

• 피드백 요청을 처음 제출했을 때와 마찬가지로 저장 및 단계적 변경 사항과 로컬 및 푸시된 커밋 중에서 선택할 수 있습니다. 열려 있는 모든 변경 요청도 나열되어 업데이트로 해결된 모든 것을 표시할 수 있습니다.

• 기본적으로 검토자가 피드백 요청으로 돌아가면 각 파일에 대한 diff를 거치면서 전체 변경 집합(예: 모든 업데이트의 변경 사항)을 보게 됩니다. 또한 개별 업데이트에 대한 차이점도 볼 수 있습니다.

피드백 요청 승인

피드백 검토 프로세스는 변경 사항의 최종 승인을 얻는 데 필요한 만큼의 업데이트에서 계속될 수 있습니다. 피드백 요청이 승인되면 CodeStream 내에서 끌어오기 요청을 생성 하여 코드를 병합할 수 있습니다.