docs(work): 확인 리뷰 상한을 넘는 한 커밋은 영역 pathspec으로 나눈다
문제: improve.md 4.4절은 확인 리뷰 하나가 보는 수정 diff를 추가 1,500줄로 묶고, 넘으면 "묶음 커밋별로" 나누라고만 했다. 여러 영역 묶음을 한 커밋에 합친 수정(예: 영역 묶음 넷을 합친 +5,143줄 커밋)은 커밋으로 나눌 수 없어, 그 확인 리뷰를 맡은 세션이 어떻게 나눌지 답이 없었다. 고른 방법: 커밋이 따로 있으면 커밋별로, 한 커밋에 섞였으면 영역 pathspec별로 `git diff --shortstat <base>..<head> -- <pathspec>`를 재서 각각 상한 안이 되게 나눈다. 지난 확인 리뷰도 영역 4개를 pathspec으로 나눠 봤다. 위험·한계: pathspec 하나가 그 자체로 1,500줄을 넘으면 더 나눌 기준은 아직 없다. 그때는 그 영역을 맡은 리뷰를 둘로 나누거나 맡긴 쪽에 묻는다. 검증 - python3 scripts/check-work-docs.py: rc=0, improve.md 132/150
This commit is contained in:
@@ -68,7 +68,7 @@
|
||||
### 4.4 수정 묶음의 크기
|
||||
|
||||
- 묶음 하나는 리뷰 영역 하나 안이고 발견 8건 이하다. 묶음마다 커밋 하나다.
|
||||
- 확인 리뷰 하나가 보는 수정 diff는 추가 1,500줄 이하다(`git diff --shortstat <base>..<head>`, 테스트 포함, lockfile·스냅숏 같은 생성 파일 제외). 넘으면 묶음 커밋별로 나눠 따로 확인 리뷰한다.
|
||||
- 확인 리뷰 하나가 보는 수정 diff는 추가 1,500줄 이하다(`git diff --shortstat <base>..<head>`, 테스트 포함, lockfile·스냅숏 같은 생성 파일 제외). 넘으면 확인 리뷰를 나눈다. 묶음 커밋이 따로 있으면 커밋별로, 한 커밋에 여러 영역이 섞였으면 영역 pathspec별로(`git diff --shortstat <base>..<head> -- <pathspec>`) 나눠 각각 상한 안이 되게 한다.
|
||||
- 왜: 지난 수정 라운드에서 추가 줄이 2,000줄 아래면 다음 확인 리뷰 발견이 9건 이하였고, 5,000줄을 넘으면 19건 이상이었다([evidence.md](evidence.md) 「수정 묶음 크기」). 상한 값은 판단이다. 라운드당 새 결함 수로 다시 맞춘다.
|
||||
- 묶음을 합친 트리는 따로 검증한다([reference/gates.md](reference/gates.md) 「라운드 끝」). 두 묶음의 수정은 한 트리에서 처음 만날 때 새 결함을 만든다.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user