From 43ed03d14fc4e42612441cd6d762eb4c9a07dc2a Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 05:23:03 +0900 Subject: [PATCH] =?UTF-8?q?docs(perf):=20=EC=B4=88=EA=B8=B0=20=ED=8C=8C?= =?UTF-8?q?=EC=9D=BC=20=EC=83=81=ED=95=9C=20=EB=AC=B8=EC=9E=A5=EC=9D=B4=20?= =?UTF-8?q?=ED=85=9C=ED=94=8C=EB=A6=BF=20=ED=8C=8C=EC=9D=BC=20=EC=88=98?= =?UTF-8?q?=EB=A5=BC=20=EA=B8=B0=EB=A1=9D=EC=97=90=EC=84=9C=20=EC=9D=BD?= =?UTF-8?q?=EA=B2=8C=20=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: `docs/operations/performance-evidence.md`의 초기 파일 상한 문장이 "상한은 템플릿 그대로의 수(26)에 6을 더한 32다"라고 적는다. 지금 기록은 27개다(`config/scale/feature-shape-ceilings.json`의 `initialJavascript.files`, FE-GATE-012 `27 / 32 files`). 기록을 27로 다시 쓴 `0fee3fe`이 이 문장을 고치지 않았다. 1103/15-02의 완료 기준 "문서·JSON에 서로 다른 기준선이 없다"를 다시 어긴다. 같은 문서의 바이트 쪽은 이미 숫자를 적지 않고 기록을 가리킨다. 고른 방법: 지금 수를 지우고, 상한 32가 정할 때 6칸을 더한 값이라는 것만 남긴다. 지금 템플릿 수는 그 기록이 정본이고 남은 칸은 32에서 그 값을 뺀 것이라고 적는다. 바이트 절의 "기준선 숫자는 이 문서에 적지 않는다"와 같은 방식이다. 숫자를 27로 고치는 대안은 버렸다. 다음에 파일이 하나 늘면 같은 식으로 낡는다. 위험·한계: 상한 값 32는 예산 값이라 그대로 적었다. `budgets.json`을 바꾸면 이 문장도 고쳐야 하고, 그것을 보는 검사는 없다. 기록 파일은 참조 기능과 함께 지워질 수 있고, 그때 문서 검사는 이 경로를 요구하지 않는다 (`scripts/lib/removable-template-features.ts`). 검증: 문서만 바꿨다. desktop batch에서 확인. corepack pnpm verify:documentation node scripts/run-vitest.ts run tests/unit/documentation-readiness.test.ts tests/unit/template-feature-removal-documents.test.ts Refs: 1103/15-02 --- docs/operations/performance-evidence.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/operations/performance-evidence.md b/docs/operations/performance-evidence.md index fe5b48f1..30de5b39 100644 --- a/docs/operations/performance-evidence.md +++ b/docs/operations/performance-evidence.md @@ -217,8 +217,10 @@ the example can never serve as production evidence. - HTTP/2에서는 (나)도 Fast 3G 85 ms, Fast 4G 22 ms 차이다(위 둘째 표). 그래서 템플릿은 HTTP/2 이상으로 서빙한다고 본다. 초기 파일 수는 -`config/performance/budgets.json`의 `initialJsFiles`가 막는다(1103/15-05). 상한은 -템플릿 그대로의 수(26)에 6을 더한 32다. 기능의 지연 페이지가 셸과 같은 구성요소 +`config/performance/budgets.json`의 `initialJsFiles`가 막는다(1103/15-05). 상한 32는 +정할 때 템플릿 그대로의 수에 6칸을 더한 값이다. 지금 템플릿 그대로의 수는 이 문서에 +적지 않는다. 위 기록 `config/scale/feature-shape-ceilings.json`의 +`initialJavascript.files`가 정본이고, 남은 칸은 32에서 그 값을 뺀 것이다. 기능의 지연 페이지가 셸과 같은 구성요소 (`Button`, `SearchField` 등)를 쓰면 그 구성요소가 별도 공유 청크로 떨어져 초기 파일이 하나 는다(1103 X2 #4). 상한을 현재 수와 같게 두면 그런 기능 하나로 게이트가 실패한다. HTTP/2에서 파일 하나는 거의 비용이 없다(위 표). 32를 넘으면 상한을 올리기