From dae6dcaf51664de908768b5668c1db1c5e3f50b0 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 08:07:42 +0900 Subject: [PATCH] =?UTF-8?q?docs(migration):=20=EB=8F=99=EC=8B=9C=20?= =?UTF-8?q?=EC=9D=B8=EB=8D=B1=EC=8A=A4=20IT=20Javadoc=EC=9D=98=20runbook?= =?UTF-8?q?=20=EC=A0=88=20=EC=9D=B4=EB=A6=84=EC=9D=84=20=EB=B0=94=EB=A1=9C?= =?UTF-8?q?=EC=9E=A1=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 (재리뷰 round8 RR8-03-02) - PostgreSqlConcurrentIndexMigrationIntegrationTest의 클래스 Javadoc이 migration-failed.md의 "A concurrent index migration failed" 절을 읽는다고 적는다. 그런 제목은 없다. 실제 절은 "Recover a failed concurrent index migration"이다. 고른 방법 - 절 이름만 고친다. 같은 원인으로 다른 문서·코드가 없는 절을 가리키는지 보려고, 문서 경로 뒤에 따옴표로 절 제목을 적은 곳을 저장소 전체(리뷰 기록 제외)에서 찾아 그 문서의 제목과 대조했다. 마이그레이션·runbook 문서를 가리키는 곳에 다른 틀린 이름은 없었다. 위험·한계 - RED 없음 — Javadoc 문구다. 틀린 문장의 출처는 위 줄, 실제 제목은 docs/runbooks/migration-failed.md의 "## Recover a failed concurrent index migration"이다. 검증 (desktop, 이 커밋의 트리 1b95ec3f, --no-build-cache, 로그 ~/r9-g3-logs/) - :adapter:outbound:persistence-jpa:spotlessCheck compilePostgresqlIntegrationTestJava rc=0, FROM-CACHE 0 Refs: docs/reviews/2026-11-03-rereview/round8/03-migration.md RR8-03-02 Fixes: 6ec0c4f7fa0d ("fix(migration): 실패한 동시 인덱스 마이그레이션 복구와 검사기 설명을 실제 동작에 맞춘다") --- .../PostgreSqlConcurrentIndexMigrationIntegrationTest.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlConcurrentIndexMigrationIntegrationTest.java b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlConcurrentIndexMigrationIntegrationTest.java index 5b7fc33d..b11cf779 100644 --- a/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlConcurrentIndexMigrationIntegrationTest.java +++ b/src/adapter/outbound/persistence-jpa/src/postgresqlIntegrationTest/java/dev/caskeleton/adapter/outbound/persistence/readiness/PostgreSqlConcurrentIndexMigrationIntegrationTest.java @@ -62,8 +62,8 @@ import org.springframework.jdbc.datasource.DelegatingDataSource; * it runs when nothing configures the file, and is left half applied when {@code * executeInTransaction=false} does: Flyway commits each statement on its own. A failed build leaves * an invalid index and a failed history row, and the deploy after it is refused until the row is - * gone: the recovery case runs the SQL of {@code docs/runbooks/migration-failed.md} ("A concurrent - * index migration failed"), read out of the runbook itself, and deploys again. + * gone: the recovery case runs the SQL of {@code docs/runbooks/migration-failed.md} ("Recover a + * failed concurrent index migration"), read out of the runbook itself, and deploys again. */ class PostgreSqlConcurrentIndexMigrationIntegrationTest {