예외 목록은 줄기만 해야 하는데 빈틈이 있다. check-docs.py는 목록의 줄이 FROZEN에 있는지만 보고, FROZEN의 지문이 목록에 있는지는 보지 않는다. 그래서 번역해서 지운 줄의 지문이 FROZEN에 남고, 같은 줄을 다시 더해도 검사가 통과한다. 기준 커밋 03a313ed에서 이미 FROZEN 217개 중 9개가 목록에 줄이 없었다(앞 단계의 이름 바꾸기에서 남은 것). - run()이 FROZEN - (목록 줄의 지문)을 실패로 낸다. --only와 상관없이 돈다(목록의 줄이 FROZEN에 있는지 보는 검사와 같다). - 합친 트리의 목록이 비었으므로 FROZEN에서 217개를 모두 뺐다. 이제 목록에 어떤 줄을 더해도 실패한다. - 설명(스크립트 머리, 예외 목록 머리 주석, docs/README.md 「문서 검사」)에 「줄을 지우면 FROZEN에서 그 지문도 뺀다」를 더했다. 스크립트 머리의 「넷 모두」를 지금의 여섯 검사로 고쳤다. 버린 대안: FROZEN을 그대로 두고 자기 시험만 더하기. 실제 검사(PR workflow)는 자기 시험과 따로 돌므로, 목록과 FROZEN이 어긋난 트리가 check-docs.py만으로는 통과한다. 검사 자신이 막아야 한다. 자기 시험(scripts/tests/test_check_docs.py)에 셋을 더했다. - test_a_frozen_fingerprint_whose_line_was_removed_fails: 고장 낸 입력 (빈 목록 + 지문 하나)이 language·head 어느 검사로 돌려도 실패한다. - test_a_removed_line_added_back_fails_once_its_fingerprint_is_gone: 지문을 뺀 뒤 줄을 다시 더하면 「기준선에 없는 예외다」로 실패하고, 남은 줄에는 고아 지문 오류가 나지 않는다. - test_every_frozen_fingerprint_has_its_line_in_the_real_exception_list: 실제 FROZEN과 실제 목록이 맞는다. 조건을 끈 변이 시험(사본에 문자열 치환, 자기 시험 실행): - 고아 지문 검사를 지움 → rc=1, 첫째 시험 실패 - FROZEN을 03a313ed의 217개로 되돌림 → rc=1, 셋째 시험 실패. 실제 트리의 check-docs.py도 고아 지문 217건으로 실패한다. - 둘 다(바꾸기 전 코드) → rc=1, 첫째·셋째 시험 실패 검증(노트북): check-docs.py OK(여섯 검사 걸림 0), 자기 시험 68 OK, check-work-docs.py OK.
14 lines
1010 B
Plaintext
14 lines
1010 B
Plaintext
# scripts/check-docs.py의 예외 목록. 2026-11-07 기준선이고 줄기만 한다.
|
|
#
|
|
# - 이 목록에 새 줄을 더하면 검사가 실패한다. 줄마다 check-docs.py의 FROZEN에 지문이 있어야 한다.
|
|
# - 번역하거나 고쳐서 더는 걸리지 않는 줄은 지운다. 남겨 두면 검사가 실패한다.
|
|
# - 줄을 지우면 같은 변경에서 FROZEN에서 그 지문도 뺀다. 남겨 두면 검사가 실패한다.
|
|
# - 2026-11-07 번역 단계에서 모든 줄을 지웠다. FROZEN도 비어 있어 어떤 줄을 더해도 실패한다.
|
|
# - 형식: <검사><탭><경로>[<탭><걸린 값>]. 「#」으로 시작하는 줄과 빈 줄은 읽지 않는다.
|
|
|
|
# 언어: 한국어로 옮기지 않은 살아 있는 문서와 ADR.
|
|
|
|
# 참조: 지금 트리·registry에 없는 경로. 고치거나 「> 이력」 인용 블록으로 옮기면 지운다.
|
|
|
|
# 숫자: 정본(src/gradle/libs.versions.toml, registry)이 정하는 값을 복사한 곳. 정본을 가리키게 고치면 지운다.
|