docs(keycloak-session-store): remake all 28 diagrams through the techviz pipeline
The originating repository's SVGs were drawn by hand and every one of them
put a title, a subtitle and an explanation band inside the canvas. This
repository forbids both, so they could not be carried over — the whole set
was rebuilt through the skill's pipeline instead.
Each diagram went through prepare, references, prompt, a VizSpec 1.1 citing
document line ranges, lint, and render. All 28 pass lint and produce the
same eight formats the existing keycloak project has. Sentences moved out of
the canvas into <desc> and the paragraph beside each figure; the drawings
carry names only.
Two lint rules did real work rather than formatting work:
edge-through-node caught arrows crossing an unrelated
node and implying an adjacency that
does not exist — four diagrams had to
be restructured, not just relaid out
evidence-outside-prepared-context caught a diagram citing another
section; its anchor moved from B-0 to
B-1 so all three sections it draws on
are inside the prepared context
lab-topology also had to change profile: its context offers a different
candidate set, and query-fanout with shard roles is what the section
actually shows — one entry point spreading to two Keycloak nodes.
The document now carries all 28 inline, one per claim that needed one, and
the section recording what was still missing is updated: the diagram gap is
closed, Studio records remain.
verify-pipeline.py passes. audit-records.py reports no issues.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
b2963105a8
commit
75bed382c8
@@ -7,18 +7,22 @@
|
||||
|
||||
## 잰 값
|
||||
|
||||
`scripts/density.mjs`로 잰 것이다.
|
||||
`scripts/density.mjs`로 잰 것이다. **글 한 편과 기록 본문은 다른 잣대로 본다.** 기록은 문제·결론·
|
||||
검증 환경·재현 조건을 Studio 칸이 따로 들고 있고, 본문의 `##`는 「본문」 칸 아래라 층이 한 단
|
||||
낮다. 그래서 본문은 절대값이 아니라 밀도로 잰다 — 절 하나가 몇 낱말인가, 1,000 낱말에 수치가
|
||||
몇 개인가.
|
||||
|
||||
| | 여섯 편 | 이 저장소의 잘 쓴 기록 (AP4) |
|
||||
| | 여섯 편 (글 한 편) | 기록 본문 기준 |
|
||||
|---|---|---|
|
||||
| 낱말 | 1,480 ~ 3,164 (중앙값 2,508) | 1,726 |
|
||||
| 문장 평균 낱말 | 17.8 | 17.3 |
|
||||
| 코드블록 | 1 ~ 13 | 8 |
|
||||
| **본문 속 수치** | **10 ~ 32개** | **1개** |
|
||||
| **`##` 절** | **4 ~ 9개** | **18개** |
|
||||
| 표 줄 | 0 ~ 15 | 37 |
|
||||
| 낱말 | 1,277 ~ 2,871 | — |
|
||||
| 문장 평균 낱말 | 14.2 ~ 18.3 | 14.2 ~ 18.3 |
|
||||
| 코드블록 | 1 ~ 13 | 1 ~ 13 |
|
||||
| 표 줄 | 0 ~ 15 | 0 ~ 15 |
|
||||
| 절당 낱말 | 160 ~ 718 | 160 ~ 718 |
|
||||
| 1,000 낱말당 수치 | 측정 글 10.2 ~ 13.8 · 구조 글 0.9 ~ 1.7 | 측정 9 ~ 45 · 구조 0.8 ~ 8 |
|
||||
|
||||
문장 길이도 코드블록 수도 이미 맞다. 갈리는 것은 셋이다.
|
||||
고치기 전 AP4 본문은 절 하나가 68 낱말, 수치는 본문 전체에 1개, 표 37줄이었다. 손대지 않은
|
||||
`clean-architecture-backend-template` 기록들은 지금도 **절 하나가 31 낱말**이다. 갈리는 것은 셋이다.
|
||||
|
||||
## 1. 수치 — 크기를 말하지 않으면 독자는 판단할 수 없다
|
||||
|
||||
|
||||
Reference in New Issue
Block a user