Repository navigation
docs(java): Maven Central 에 게시되는 javadoc 을 영문으로 + java 레인 가드 — 번역 판정이 java 를 빠뜨렸다 (korean-api-docs-in-published-packages) - #913
Merged
Conversation
…역 판정이 java 를 빠뜨렸다 (korean-api-docs-in-published-packages) 판정 2026-10-29 「번역 — 언어당 PR」은 일곱 언어(#890–#898)만 옮겼고, CHANGELOG 는 「아홉 SDK 의 그려지는 문서가 모두 영문」이라 적었다. 그려지는 문서 가드를 레인마다 걸려고 재다가 java 가 0 이 아님을 찾았다 — 게시용 `-javadoc.jar`(`-Prelease package`, reactor 안) 122 HTML 에 한글 221 줄: facade 20 · admin 138 · auth 5 · core 50 · examples 8. (.NET 은 XML 문서 파일이 이미 0 줄이다.) 범위: 그 221 줄을 낳는 11 파일의 javadoc(공개·protected 요소)과, README 가 링크하는 QuickStart.java 의 주석. 비공개·package-private 의 javadoc 과 그 밖의 `//` 주석(66 줄)은 그려지지 않아 그대로 뒀다. 정정 하나: QuickStart 의 「모듈 POM 의 `maven.deploy.skip=true` 로 배포되지 않는다」는 원문부터 거짓이었다 — 그 속성은 무효였고(examples 모듈 POM 의 주석), 제외 장치는 부모 POM 의 `<excludeArtifacts>` 다. 구현은 에이전트(지정 11 파일 · 금지 목록 · 검증 명령)가 했고, PM 이 다른 계측기로 다시 쟀다: - 오라클: 같은 `package` → 122 파일 · 한글 0(양성 대조: core 의 영문 요약이 index 에 있다) - 코드 불변: `javap -v -p`(상수 풀 · 부트스트랩 메서드 포함 — 줄 번호 표 · 체크섬 · 시각만 거름)를 main 빌드와 비교 — 59 클래스 22,687 줄 동일. 대조: 필터 뒤 남은 상수 풀 · 부트스트랩 줄 4,755. - 에이전트의 `javap -c -p -constants` 도 동일(8,431 줄, SHA-256 같음). - 번역 충실도: ResponseLimits · KeycloakConfig · AdminClient · QuickStart 를 원문과 나란히 읽었다 — 수치(65,459 B · 32 MiB/170 MB/17.2 GB · 85 B · 9)와 조건·인과가 그대로다. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R4jYS4tpj7usahf8MK5dXo
… 닫는다 (korean-api-docs-in-published-packages) java 레인 가드 — `release-bundle` 잡이 만드는 Central 번들(게시되는 그대로, examples 는 부모 POM 의 <excludeArtifacts> 로 빠진다)에서 `*-javadoc.jar` 를 꺼내 풀고 #911 의 계수기로 센다. 번들에 javadoc 이 없으면 읽은 파일 0 으로 실패한다(exit 2). `paths:` 에 계수기를 더했다. 로컬 실측 — CI 와 같은 명령(versions:set 0.0.0-bundle-check → -Prelease deploy -DskipUpload)으로 번들을 만들어: 번역 뒤: javadoc jar 4 · 110 HTML · 한글 0 ResponseLimits 의 공개 javadoc 에 한글 한 줄을 심어 다시 만들면: `ResponseLimits.html:97` 한 줄을 잡는다 (그 실행의 「rc=0」은 내 검증 스크립트가 `| head` 로 계수기의 종료코드를 가린 탓이다 — CI 단계는 파이프 없이 `set -euo pipefail` 아래에서 돌고, 계수기가 발견 시 1 을 내는 것은 자가테스트가 고정한다). CHANGELOG — python 항목 끝의 「이로써 아홉 SDK 의 그려지는 문서가 모두 영문입니다」는 그때 거짓이었다(java). 그 문장을 떼고 java 항목에 붙였다 — 이 PR 이 들어가면 참이다. 등록부 — 항목을 닫는다(표제 한 줄): 그려지는 문서는 아홉 레인 가드(#911 · #912 · 이 PR), 런타임 문구는 #908. 진입점을 2026-10-30 으로 고치고 남은 칸 목록에서 이 항목을 뺐다. 함정 한 줄: 측정이 도는 워크트리를 지우지 않는다 — 옛 오탐 측정기가 `|| true` 로 git 실패를 삼켜 거짓 수(존재 408 · 불일치 1)를 냈다. D 절 머리 열림 51 → 50 · 「규모」의 날짜 붙은 수 → 2026-10-30 기준 열림 130 · 닫힘 154. 예산 래칫(검사 8e)대로 앵커를 내렸다: 적재 174,781 → 173,995 · raw 199,954 → 199,140. 검증(main d5d7789 위): test-remaining-work-shape 28/0 · test-selftest-hygiene 241/0 · check-ci-permissions rc=0 · check-docs rc=0 · test-changelog-landing 16/0 · test-changelog-ledger 68/0 · CHANGELOG java 항목 468 B. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R4jYS4tpj7usahf8MK5dXo
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
무엇을
korean-api-docs-in-published-packages를 닫는다. 판정 2026-10-29 「번역 — 언어당 PR」은 일곱 언어(#890–#898)만 옮겼다 — java 가 빠졌다. 그려지는 문서 가드를 레인마다 걸려고 재다가 찾았다: 게시용-javadoc.jar122 HTML 에 한글 221 줄(facade 20 · admin 138 · auth 5 · core 50 · examples 8). CHANGELOG 의 「아홉 SDK 의 그려지는 문서가 모두 영문」은 그때 거짓이었다.QuickStart.java주석. 비공개 javadoc · 그 밖의//주석(66 줄)은 그려지지 않아 그대로. 정정 하나: QuickStart 의 「모듈 POM 의maven.deploy.skip=true로 배포 안 됨」은 원문부터 거짓이었다(그 속성은 무효 — 제외 장치는 부모 POM 의<excludeArtifacts>).release-bundle잡이 만드는 Central 번들에서*-javadoc.jar를 풀어 ci(node·go·rust·ruby): 그려지는 문서 한글 0 을 레인 CI 가 센다 — 산출물을 만들고 공용 계수기로 (korean-api-docs-in-published-packages) #911 의 계수기로 센다.검증 — 구현(에이전트)과 다른 계측기로 PM 이 다시 쟀다
-Prelease package→ 5 jar 풀어 계수기-Prelease deploy -DskipUpload→ 번들의 jar 4ResponseLimits.html:97을 잡는다javap -v -p(상수 풀 · 부트스트랩 메서드 포함, 줄 번호 표 · 체크섬 · 시각만 거름) vs main 빌드javap -c -p -constants| head로 종료코드를 가린 탓이다(함정 (r)) — CI 단계는 파이프 없이set -euo pipefail아래에서 돌고, 계수기의 exit 1 은 자가테스트가 고정한다.병합 순서
#912(.NET · kotlin · python · php 가드) 뒤에 병합한다 — 등록부가 「아홉 레인 가드」라 적기 때문이다.
🤖 Generated with Claude Code
https://claude.ai/code/session_01R4jYS4tpj7usahf8MK5dXo