SIG Docs 승인자는 리포지터리에 대해 일주일 동안 교대로 풀 리퀘스트 관리를 수행한다.
이 섹션은 PR 랭글러의 의무에 대해 다룬다. 좋은 리뷰 제공에 대한 자세한 내용은 변경 사항 리뷰하기를 참고한다.
PR 랭글러는 일주일 간 매일 다음의 일을 해야 한다.
size/XS)부터 시작하고, 가장 큰(size/XXL) PR까지 리뷰한다.
가능한 한 많은 PR을 리뷰한다.sig/ 레이블을 할당한다.reviewers: 블록의 리뷰어를 할당한다.@kubernetes/<sig>-pr-reviews 라는 코멘트를 남겨 SIG가
리뷰하도록 태그할 수 있다./approve 코멘트를 사용한다. 준비가 되면 PR을 병합한다./lgtm 코멘트를 받아야 한다.다음의 쿼리는 랭글러에게 도움이 된다. 이 쿼리들을 수행하여 작업한 후에는, 리뷰할 나머지 PR 목록은 일반적으로 작다. 이 쿼리들은 특히 현지화 PR을 제외한다. 모든 쿼리는 마지막 쿼리를 제외하고 메인 브렌치를 대상으로 한다.
/approve 코멘트가 필요한 PR을 나열한다.dev- 브랜치에 대한 것일 경우, 곧 출시될 예정인 릴리스이다. /assign @<manager's_github-username> 을 사용하여
문서 릴리스 관리자를
할당한다. 오래된 브랜치에 대한 PR인 경우,
PR 작성자가 가장 적합한 브랜치를 대상으로 하고 있는지 여부를 파악할 수 있도록 도와준다.# 한글 레이블 추가
/language ko
# 둘 이상의 커밋인 경우 PR에 스쿼시 레이블 추가
/label tide/merge-method-squash
# Prow를 통해 PR 제목 변경(예: 진행 중인 작업(work-in-progress) [WIP] 또는 PR의 더 상세한 내용)
/retitle [WIP] <TITLE>
리뷰와 승인은 PR 대기열을 최신 상태로 유지하는 도구 중 하나이다. 또 다른 도구는 종료(closure)이다.
다음의 상황에서 PR을 닫는다.
작성자가 CLA에 2주 동안 서명하지 않았다.
작성자는 CLA에 서명한 후 PR에 다시 열 수 있다. 이는 CLA 서명 없이 어떤 것도 병합되지 않도록 보장하는 저위험(row-risk) 방식이다.
작성자가 2주 이상 동안 코멘트나 피드백에 응답하지 않았다.
풀 리퀘스트를 닫는 것을 두려워하지 말자. 기여자는 진행 중인 작업을 쉽게 다시 열고 다시 시작할 수 있다. 종종 종료 통지는 작성자가 기여를 재개하고 끝내도록 자극하는 것이다.
풀 리퀘스트를 닫으려면, PR에 /close 코멘트를 남긴다.
k8s-triage-robot이라는 봇은
90일 동안 활동이 없으면 이슈를 오래된 것(stale)으로 표시한다. 30일이 더 지나면 rotten으로 표시하고
종료한다. PR 랭글러는 14-30일 동안 활동이 없으면 이슈를 닫아야 한다.2021년 말에, SIG Docs는 PR 랭글러 섀도우 프로그램을 도입했다. 이 프로그램은 새로운 기여자가 PR 랭글링 과정을 이해하는 데 도움을 주기 위해 도입되었다.
PR 랭글러 섀도우 활동에 관심이 있다면, PR 랭글러 위키 페이지에서 올해의 PR 랭글링 스케줄을 확인하고 지원한다.
다른 사람들은 특정 주간에 배정된 PR 랭글러의 섀도우 기여를 요청하기 위해 #sig-docs 슬랙 채널 을 통해 문의할 수 있다. 궁금한 점이 있다면 언제든 SIG Docs 공동 의장 및 리드(co-chairs/leads) 중 한 명에게 문의한다.
PR 랭글러 섀도우를 신청했다면, 쿠버네티스 슬랙에서 해당 PR 랭글러에게 자기소개를 한다.