Files
grpc-library/docs
DongHyeonka f88f180ab6
pr / ci (pull_request) Successful in 3m40s
fix(release): SIGNING_PASSWORD에 키 블록이 들어간 경우를 이름 댄다
signing-check(run 15)가 남은 실패의 원인을 보였다. SIGNING_PASSWORD는
3,473글자에 줄바꿈 56개였다. 앞 run에서 base64를 푼 armored 키(3,474글자,
58줄)와 같은 모양이다. Gradle 서명기는 「checksum mismatch at in checksum
of 20 bytes」, 곧 틀린 비밀번호로 실패했다. 비밀번호 칸에 키가 들어갔다.

진단이 이 경우를 바로 말한다. 비밀번호에 「-----BEGIN PGP」가 있거나
1,000글자를 넘으면, 그것이 비밀번호가 아니라는 PROBLEM 줄을 낸다(값은
출력하지 않는다). release.md 1절에 SIGNING_PASSWORD는 키를 만들 때 정한
암호 한 줄이라고 적었다.

검증: 로컬 gpg로 armored 키를 비밀번호로 준 경우 PROBLEM 줄과 rc=1(아래
signing-check 실행).
2026-11-08 15:22:32 +09:00
..

문서 지도

1. 어디에 무엇이 있나

폴더 종류 고치는 법
work/ 작업 방법(고치기, 게이트, 릴리스) 살아 있는 문서. 동작이 바뀌면 같은 변경에서 고친다
compatibility/ 지원 매트릭스(무엇을 인증했나) 살아 있는 문서
runbooks/ 운영 대응 살아 있는 문서
adr/ 결정 기록(ADR-GRPC-*) 기록. 본문은 고치지 않는다
design/ 설계서 기록. 본문은 고치지 않는다
ledger/ 예측·실측 장부 줄을 더하기만 한다
vision.md, problem-statement.md 방향, 풀 문제 vision.md는 소유자만 쓴다

2. 기록 문서의 머리 블록

adr/와 design/의 문서는 맨 위에 머리 블록을 둔다. 본문은 쓴 때의 원문이고, 지금도 맞는지는 머리 블록이 말한다.

<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **결정 기록** 본문은 결정한 때의 내용이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.

- 상태: 채택 | 대체됨(무엇으로) | 폐기
- 작성일: YYYY-MM-DD
- 요약: 한 문장
- 현재 정본: 지금 동작을 설명하는 살아 있는 문서 경로
<!-- 머리 블록 끝 -->

지난 결정이 바뀌면 본문은 두고 「상태」와 「현재 정본」만 고친다. 템플릿에서 옮겨 온 기록의 본문 경로(src/platforms/…, .github/workflows/…)는 그 결정 때의 템플릿 경로다.