Merge branch 'claude/d2c-ops-docs-1-c22c9f' — runbook·알림·JPA·관측·호환·storage 문서 번역
충돌: scripts/check-docs-exceptions.txt. 두 쪽 모두 줄을 지우기만 했다(앞 병합까지 92줄, D2c 67줄, 겹침 0). 기준의 줄 중 두 쪽이 모두 남긴 줄만 남겼다(128 → 61줄).
This commit is contained in:
+11
-2
@@ -55,6 +55,13 @@ final class NotificationEvidenceVerifier {
|
||||
/** A contract may extend a base; a longer chain is not followed. */
|
||||
private static final int MAX_SUPERCLASS_DEPTH = 3;
|
||||
|
||||
/**
|
||||
* The header of the column a table assigns grades in. The support matrix is written in Korean
|
||||
* (docs/README.md), so its grade column is headed 등급; a table whose grade column is the first one
|
||||
* lists what each grade requires and assigns nothing.
|
||||
*/
|
||||
private static final String GRADE_COLUMN_HEADER = "등급";
|
||||
|
||||
private static final Pattern SUPERCLASS =
|
||||
Pattern.compile("\\bclass\\s+\\w+\\s+extends\\s+(\\w+)");
|
||||
private static final Pattern PACKAGE = Pattern.compile("(?m)^package\\s+([\\w.]+)\\s*;");
|
||||
@@ -117,7 +124,7 @@ final class NotificationEvidenceVerifier {
|
||||
}
|
||||
if (!insideTable) {
|
||||
insideTable = true;
|
||||
gradeColumn = cells.indexOf("Grade");
|
||||
gradeColumn = cells.indexOf(GRADE_COLUMN_HEADER);
|
||||
if (gradeColumn > 0) {
|
||||
gradeAssigningTables++;
|
||||
} else {
|
||||
@@ -182,7 +189,9 @@ final class NotificationEvidenceVerifier {
|
||||
throw new IllegalStateException(
|
||||
"notification evidence: "
|
||||
+ matrixFile.getName()
|
||||
+ " has no table that assigns a grade (a 'Grade' column that is not the first"
|
||||
+ " has no table that assigns a grade (a '"
|
||||
+ GRADE_COLUMN_HEADER
|
||||
+ "' column that is not the first"
|
||||
+ " column), so no claim in it was checked.");
|
||||
}
|
||||
if (!problems.isEmpty()) {
|
||||
|
||||
+3
-3
@@ -150,7 +150,7 @@ class NotificationEvidenceVerifierTest {
|
||||
Files.writeString(
|
||||
fixture.matrix(),
|
||||
"""
|
||||
| Channel | Grade |
|
||||
| 채널 | 등급 |
|
||||
| --- | --- |
|
||||
| email | Experimental |
|
||||
""");
|
||||
@@ -174,7 +174,7 @@ class NotificationEvidenceVerifierTest {
|
||||
Files.writeString(
|
||||
fixture.matrix(),
|
||||
"""
|
||||
| Grade | Requires |
|
||||
| 등급 | 필요한 claim |
|
||||
| --- | --- |
|
||||
| Stable | delivery |
|
||||
""");
|
||||
@@ -248,7 +248,7 @@ class NotificationEvidenceVerifierTest {
|
||||
Files.writeString(
|
||||
matrix,
|
||||
"""
|
||||
| Channel | Grade |
|
||||
| 채널 | 등급 |
|
||||
| --- | --- |
|
||||
| email | Stable |
|
||||
""");
|
||||
|
||||
+7
-5
@@ -42,14 +42,16 @@ class NotificationReleaseGateTest {
|
||||
// The terms must appear, but only under the refusal heading. Asserting they are absent
|
||||
// altogether would be the wrong test: a matrix that never mentions guaranteed delivery leaves
|
||||
// the reader to assume it, which is exactly the assumption this document exists to remove.
|
||||
int refusalHeading = text.indexOf("## Not supported");
|
||||
int refusalHeading = text.indexOf("## 지원하지 않는 것");
|
||||
assertThat(refusalHeading).as("the matrix must state what it refuses to claim").isPositive();
|
||||
|
||||
String claims = text.substring(0, refusalHeading);
|
||||
String refusals = text.substring(refusalHeading);
|
||||
|
||||
assertThat(claims).doesNotContain("guaranteed delivery", "guaranteed read", "exactly-once");
|
||||
assertThat(refusals).contains("guaranteed delivery", "guaranteed read", "exactly-once");
|
||||
assertThat(claims)
|
||||
.doesNotContain(
|
||||
"전달 보장", "읽음 보장", "정확히 한 번", "guaranteed delivery", "guaranteed read", "exactly-once");
|
||||
assertThat(refusals).contains("전달 보장", "읽음 보장", "정확히 한 번");
|
||||
assertThat(text).contains("PROVIDER_ACCEPTED", "AMBIGUOUS", "FCM_FID");
|
||||
}
|
||||
|
||||
@@ -57,7 +59,7 @@ class NotificationReleaseGateTest {
|
||||
void theEvidenceDocumentStatesTheForbiddenPromotions() throws IOException {
|
||||
String text = Files.readString(DOCS.resolve("support-matrix.md"));
|
||||
|
||||
assertThat(text).contains("is not `DEVICE_DELIVERED`");
|
||||
assertThat(text).contains("is not `DELIVERED`");
|
||||
assertThat(text).contains("`DEVICE_DELIVERED`가 아니다");
|
||||
assertThat(text).contains("`DELIVERED`가 아니다");
|
||||
}
|
||||
}
|
||||
|
||||
+7
-4
@@ -46,7 +46,7 @@ class PoolLaneClaimTest {
|
||||
private static final String REMOVED_FLAG = "performance." + "assertions." + "enabled";
|
||||
|
||||
@Test
|
||||
@DisplayName("no file describing the pool lane mentions the flag that was removed")
|
||||
@DisplayName("풀 lane을 설명하는 파일은 지운 스위치를 말하지 않는다")
|
||||
void noFileMentionsTheRemovedFlag() {
|
||||
for (String description : LANE_DESCRIPTIONS) {
|
||||
assertThat(read(description))
|
||||
@@ -56,7 +56,7 @@ class PoolLaneClaimTest {
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("no file describing the pool lane claims a certification or a machine bound")
|
||||
@DisplayName("풀 lane을 설명하는 파일은 인증이나 기계 상한을 주장하지 않는다")
|
||||
void noFileClaimsACertificationOrAMachineBound() {
|
||||
for (String description : LANE_DESCRIPTIONS) {
|
||||
String text = read(description).toLowerCase(Locale.ROOT);
|
||||
@@ -68,12 +68,15 @@ class PoolLaneClaimTest {
|
||||
.as("%s describes the pool lane as certifying something it does not measure", description)
|
||||
.doesNotContain("pool pressure certification")
|
||||
.doesNotContain("machine-dependent bounds")
|
||||
.doesNotContain("machine bounds");
|
||||
.doesNotContain("machine bounds")
|
||||
.doesNotContain("풀 압력 인증")
|
||||
.doesNotContain("기계 상한")
|
||||
.doesNotContain("기계에 따라 다른 상한");
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("the nightly job runs the behaviour lane, under its behaviour name")
|
||||
@DisplayName("nightly job은 동작 lane을 그 동작 이름으로 돌린다")
|
||||
void theNightlyJobRunsTheBehaviourLane() {
|
||||
String nightly = read(".github/workflows/jpa-nightly.yml");
|
||||
|
||||
|
||||
+7
-7
@@ -28,7 +28,7 @@ class JpaDocumentationContractTest {
|
||||
private final JpaReleaseManifest manifest = JpaReleaseManifest.loadFromRepository();
|
||||
|
||||
@Test
|
||||
@DisplayName("the support matrix names the registry's provider baseline, not the target")
|
||||
@DisplayName("지원 매트릭스는 목표가 아니라 registry의 provider 기준선을 이름 댄다")
|
||||
void theSupportMatrixNamesTheRegistrysProviderBaseline() {
|
||||
String matrix = read("docs/jpa/support-matrix.md");
|
||||
|
||||
@@ -42,7 +42,7 @@ class JpaDocumentationContractTest {
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("every gate the registry declares is named in the support matrix")
|
||||
@DisplayName("registry가 선언한 gate는 모두 지원 매트릭스에 이름이 있다")
|
||||
void everyRegistryGateIsNamedInTheSupportMatrix() {
|
||||
String matrix = read("docs/jpa/support-matrix.md");
|
||||
|
||||
@@ -52,7 +52,7 @@ class JpaDocumentationContractTest {
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("the H2 passage separates measurement from guarantee")
|
||||
@DisplayName("H2 단락은 측정과 보장을 가른다")
|
||||
void theH2PassageSeparatesMeasurementFromGuarantee() {
|
||||
String matrix = read("docs/jpa/support-matrix.md");
|
||||
|
||||
@@ -62,18 +62,18 @@ class JpaDocumentationContractTest {
|
||||
|
||||
assertThat(flowed)
|
||||
.as("two documents disagreed about SKIP LOCKED because they answered different questions")
|
||||
.contains("not a production guarantee")
|
||||
.contains("PostgreSQL contract evidence");
|
||||
.contains("운영 보장이 아니")
|
||||
.contains("PostgreSQL 계약 증거");
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("the boundary document states the gap it does not enforce")
|
||||
@DisplayName("경계 문서는 강제하지 않는 빈틈을 밝힌다")
|
||||
void theBoundaryDocumentStatesItsGap() {
|
||||
String adaptation = read("docs/jpa/repository-adaptation.md");
|
||||
|
||||
assertThat(adaptation)
|
||||
.as("a document may call a boundary enforced only where a test actually enforces it")
|
||||
.contains("Known gap");
|
||||
.contains("알려진 빈틈");
|
||||
}
|
||||
|
||||
private static String read(String repositoryRelativePath) {
|
||||
|
||||
Reference in New Issue
Block a user