Skip to content

ci(dotnet·kotlin) · test(python·php): 그려지는 문서 한글 0 — 남은 레인 넷 (korean-api-docs-in-published-packages) - #912

Merged
xzawed merged 1 commit into
mainfrom
feat/rendered-docs-hangul-guard-b
Oct 30, 2026
Merged

xzawed merged 1 commit into
mainfrom
feat/rendered-docs-hangul-guard-b

Conversation

@xzawed

@xzawed xzawed commented Oct 30, 2026

Copy link
Copy Markdown
Owner

무엇을

#911 의 그려지는 문서 한글 계수기를 남은 레인 넷에 건다 — .NET · kotlin(CI 단계) · python · php(레인 단위 시험). java 는 게시 javadoc 이 0 이 아니라(한글 221 줄) 번역과 함께 다음 PR 이 건다.

레인 산출물 · 장치 로컬 기준선 공개 문서에 한글 한 줄을 심으면
.NET XML 문서 파일(Directory.Build.props 의 GenerateDocumentationFile — 패키지에 실린다) · 계수기 1 파일 · 0 1 줄 → exit 1
kotlin Dokka(게시 -javadoc.jar 의 원천) · 계수기(폰트는 NUL 판정으로 건너뜀) 191 텍스트 · 0(바이너리 10) 2 줄 → exit 1
python pydoc 플레인 렌더, 공개 모듈 22(정의는 test_hostile_path_matrix._public_module 을 import) · 단위 시험 2 통과 전체 스위트에서 이 시험만 FAILED
php Reflection — 타입 + 그 타입이 선언한 public·protected 상수·프로퍼티(승격 포함)·메서드 docblock · 단위 시험 2 통과 705 시험 중 이 시험만 실패

복원 뒤 모두 porcelain 0. python·php 는 번역 PR(#895 · #898)의 덤프 스크립트가 커밋되지 않아 오라클을 시험으로 들였다(범위는 그 PR 본문 그대로 — python 공개 모듈 수 22 가 #898 과 같다).

WBS

[x] 1 레인 넷 배선 · 로컬 기준선 0 · RED · 복원                         PM
[x] 2 정적 게이트 — ruff · phpstan max · php-cs-fixer · selftest-hygiene 241/0 · ci-permissions · check-docs  PM
[ ] 3 CI 초록(새 단계가 실제로 몇 파일을 셌는지 로그로 확인) → 병합       PM
[ ] 4 다음 PR — java 번역 + java 레인(번들의 -javadoc.jar) + 등록부 항목 닫기

🤖 Generated with Claude Code

https://claude.ai/code/session_01R4jYS4tpj7usahf8MK5dXo

…api-docs-in-published-packages)

#911 의 계수기를 남은 레인에 건다. java 는 산출물이 0 이 아니라(게시 javadoc 한글 221 줄) 번역과 함께
다음 PR 이 건다.

| 레인 | 산출물 · 장치 | 자리 |
| .NET | XML 문서 파일(Directory.Build.props 의 GenerateDocumentationFile — 패키지에 실린다) · 계수기 | build-test 잡(Build 뒤) |
| kotlin | Dokka(게시 -javadoc.jar 의 원천) · 계수기(폰트는 NUL 판정으로 건너뜀) | build-test 잡 |
| python | pydoc 플레인 텍스트 렌더(공개 모듈 22 — 「공개」 정의는 test_hostile_path_matrix 에서 import) · 단위 시험 | 레인 스위트 |
| php | Reflection — 타입과 그 타입이 선언한 public·protected 상수·프로퍼티(승격 포함)·메서드 docblock · 단위 시험 | 레인 스위트 |
python·php 는 CI 렌더러가 없어(번역 PR 의 덤프 스크립트는 커밋되지 않았다) 오라클을 시험으로 들였다. pydoc 의
FILE 줄(경로)은 세지 않는다 — 한글 이름 디렉터리에 체크아웃해도 거짓 빨강이 아니다.

로컬 실측(CI 단계·시험과 같은 명령, 공개 멤버 문서에 한글 한 줄을 심어 → 복원):
| 레인 | 기준선 | 심은 뒤 | 복원 |
| .NET | XML 1 파일 · 0 | 1 줄 → exit 1 | porcelain 0 |
| kotlin | 191 텍스트 파일 · 0(바이너리 10 건너뜀) | 2 줄 → exit 1 | porcelain 0 |
| python | 2 통과 | 전체 단위 스위트에서 이 시험만 FAILED | 2 통과 · porcelain 0 |
| php | 2 통과(단언 5) | 705 시험 중 이 시험만 실패 | 통과 · porcelain 0 |

검증: ruff check/format · phpstan(max) · php-cs-fixer · test-selftest-hygiene 241/0 ·
check-ci-permissions rc=0 · check-docs rc=0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R4jYS4tpj7usahf8MK5dXo
@sonarqubecloud

Copy link
Copy Markdown

@xzawed
xzawed merged commit 27e8c61 into main Oct 30, 2026
56 checks passed
@xzawed
xzawed deleted the feat/rendered-docs-hangul-guard-b branch October 30, 2026 10:03
xzawed added a commit that referenced this pull request Oct 30, 2026
… java 를 빠뜨렸다 (korean-api-docs-in-published-packages) (#913)

* docs(java): Maven Central 에 게시되는 javadoc 과 QuickStart 예제 주석을 영문으로 — 번역 판정이 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

* ci(java) · docs: java 레인이 번들의 -javadoc.jar 를 센다 · CHANGELOG · 등록부 항목을 닫는다 (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

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant