refactor: 문서 개선 중

2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -21,7 +21,7 @@ source:

 # 두 번째 플랫폼이 첫 번째의 bridge 부재는 막고 게이트 배선은 옮기지 않았다

-gRPC 가족은 messaging 을 명시적으로 참조하며 만들어졌다. 옮겨진 것 셋은 전부 레지스트리와 빌드 파일로 표현되는 규칙이고, 옮겨지지 않은 것 셋은 전부 Gradle 태스크와 CI 설정으로 표현되는 규칙이다.
+gRPC 가족은 messaging을 명시적으로 참조하며 만들어졌다. 현재 두 가족을 비교하면 옮겨진 것 셋은 레지스트리와 빌드 파일에, 옮겨지지 않은 것 셋은 Gradle 태스크와 CI 설정에 나타난다. 이 분포는 관찰된 상관이며, 표현 형식 때문에 전이가 일어나거나 실패했다고 단정할 evidence는 없다.

 ## 관계

@@ -56,7 +56,7 @@ gRPC 가족은 그 이후에 만들어졌고 messaging 을 명시적으로 참
 CI 가 돌리는 게이트. 28개 워크플로 중 gRPC 를 이름에 담은 것이 0 이다.
 조립에 연결된 시작 검증기. 검증기는 있고 자동설정이 부르지 않는다.

-분류가 깨끗하다. 옮겨진 셋은 전부 다음 사람이 편집하게 되는 파일에 있고, 옮겨지지 않은 셋은 전부 그렇지 않은 파일에 있다.
+이번 두 가족에서는 분포가 뚜렷하다. 옮겨진 셋은 다음 변경자가 자주 만나는 레지스트리와 빌드 파일에 있고, 옮겨지지 않은 셋은 Gradle 태스크와 CI 설정 쪽에 있다. 다만 이 위치 차이를 누락의 원인으로 보지는 않는다.

 운영 문서는 그 상태를 정확히 공시한다. 출시되지 않았고 빌드 전용이라고 적는다. 이 점에서 messaging 의 지원 매트릭스와 대비된다.

@@ -23,16 +23,16 @@ verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지
 1. 규칙이 어디에 적혀 있는지가 전이 여부를 정한다
   다음 사람이 같은 파일을 편집하면서 마주치는 규칙은 따라 하게 된다. 마주치지 않는 규칙은 그렇지 않다.

-2. 마주치는 자리는 레지스트리와 빌드 파일과 타입 시그니처다
+2. 새 모듈을 만들 때 반드시 여는 파일에 규칙을 둔다
   새 모듈을 만들려면 그 파일들을 반드시 연다.

-3. 마주치지 않는 자리는 Gradle 태스크와 CI 설정이다
+3. 별도로 찾아야 하는 Gradle 태스크와 CI 규칙은 체크리스트에 넣는다
   새 모듈을 만들면서 워크플로 파일을 열 이유가 없다.

 4. CI 로만 표현된 규칙은 복제 시 명시적으로 옮긴다
   전이되지 않는다고 단정하기보다, 복제 체크리스트에 그 항목을 두는 것이 안전한 형태다.

-5. 이력이 남은 자리도 같은 기준으로 본다
+5. 결함 이력도 다음 구현자가 실제로 읽는 문서에 연결한다
   앞선 결함의 기록이 다른 가족의 테스트 파일에만 있으면 그 기록은 전이되지 않는다.

 ## 적용 조건