docs(adr)!: 알림 결정 기록을 docs/adr로 옮긴다
결정 기록이 두 폴더(docs/adr/, docs/notification/adr/)에 나뉘어 있다. 문서 지도, 수명 표, 머리 블록 절, 문서 검사의 결정 기록 폴더 목록이 모두 두 폴더를 따로 적어야 하고, 루트 README의 「왜 이렇게 정했는지 보기」도 두 곳을 가리킨다. NOTIF-ADR-001~005를 이름 그대로 docs/adr/로 옮긴다(git mv, 본문·머리 블록 그대로). 가리키던 곳을 함께 고친다. - 루트 README 문서 지도 행, docs/README.md 지도·수명 표·머리 블록 절 - scripts/check-docs.py의 RECORD_KINDS·DECISION_PREFIXES와 설명 - NotificationReleaseGateTest: ADR 넷의 존재를 docs/adr/에서 본다 - docs/upgrade/2026-11-docs-records.md: 옮긴 경로 표와 찾는 명령 파일 이름 앞머리(NOTIF-ADR-)는 바꾸지 않았다. 설계서·리뷰·모듈 문서가 NOTIF-ADR-005처럼 번호로 부르고 있어, 이름을 ADR-NOTIF-로 바꾸면 기록 본문의 부름이 맞지 않게 된다. 위험: 이 ADR을 가리키던 문서·주석을 가진 파생 서비스는 경로를 바꿔야 한다(upgrade 안내 3절). notification-platform.yml의 pull_request 경로 필터 docs/notification/**는 이제 이 ADR을 보지 않는다. ADR 존재 시험 (NotificationReleaseGateTest)은 PR의 ci(:adapter:outbound:notification: check)에서 계속 돈다. workflow는 이 변경에서 고치지 않았다. 이 ADR을 예외로 둔 줄은 없었다(합친 트리의 예외 목록이 이미 비어 있다). 검증(노트북): check-docs.py OK(language·head·reference·number·map· readme 걸림 0), 자기 시험 65 OK, check-work-docs.py OK, check-repo-layout.py OK, 살아 있는 문서에서 notification/adr 참조 0. BREAKING CHANGE: docs/notification/adr/NOTIF-ADR-*.md가 docs/adr/로 옮겨졌다. 파생 서비스 문서·주석의 옛 경로를 docs/adr/NOTIF-ADR-*.md로 바꾼다.
This commit is contained in:
@@ -7,7 +7,7 @@
|
||||
language 살아 있는 문서(기록이 아닌 .md)는 한국어다. 판정은 보고 언어 훅 H11과 같다:
|
||||
코드·명령·인용·링크·URL·경로·파일 이름을 빼고, 영어 낱말이 3개 이상이고
|
||||
한글 덩어리 비율이 0.3 미만이면 영어다.
|
||||
head 기록(docs/design, docs/history, docs/adr, docs/notification/adr)의 .md는 맨 위에
|
||||
head 기록(docs/design, docs/history, docs/adr)의 .md는 맨 위에
|
||||
머리 블록이 있다. 상태는 종류별 고정 어휘, 작성일은 날짜, 요약은 한국어, 현재
|
||||
정본과 대체됨이 가리키는 경로는 지금 있다.
|
||||
reference 살아 있는 문서의 인라인 코드 안 repo 경로(src/, docs/, scripts/, compose/, .github/로
|
||||
@@ -63,11 +63,10 @@ RECORD_KINDS = [
|
||||
("docs/history/evidence/", "증거"),
|
||||
("docs/history/study/", "학습 문서"),
|
||||
("docs/adr/", "결정 기록"),
|
||||
("docs/notification/adr/", "결정 기록"),
|
||||
]
|
||||
# 리뷰도 기록이다. 머리 블록은 아직 요구하지 않는다(docs/README.md).
|
||||
NOT_LIVING = ("docs/design/", "docs/history/", "docs/reviews/")
|
||||
DECISION_PREFIXES = ("docs/adr/", "docs/notification/adr/")
|
||||
DECISION_PREFIXES = ("docs/adr/",)
|
||||
# 살아 있는 문서 중 지운 것을 일부러 적는 곳: 제거 표, 파생 서비스용 변경 안내, 매뉴얼 규칙의 근거 기록.
|
||||
# 참조·숫자 검사는 이 문서들을 보지 않는다(docs/README.md 「문서와 코드를 같은 변경에서 고친다」).
|
||||
HISTORY_HOLDERS = ("docs/capability-status.md", "docs/upgrade/", "docs/work/evidence.md")
|
||||
|
||||
Reference in New Issue
Block a user