refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
+4 -2
View File
@@ -37,6 +37,8 @@
| `final/` | SSOT — 이 프로젝트에 대해 아는 것 전부 |
| `tech-log-studio/` | SSOT 에서 뽑아 쓴 글. 정본은 `tech-log-tree.json` |
## 반입하는 동안에만 있는 것
## source/ 정책 — durable import snapshot
`source/` — 밖에서 가져온 원본. `final/` 내용을 담으면 지운다.
`source/` 는 이 프로젝트에서는 임시 작업 재료가 아니다. 제5~6부의 실험대 문서는 `9465582b5d1630eb4ae7c4e078021486919bf6b6` 을 HEAD 로 둔 **미커밋 working tree**에서 반입됐고, 반입한 바이트와 정확히 같은 commit은 찾지 못했다. 따라서 `source/` 시점의 바이트를 고정하는 durable import snapshot 역할을 한다.
`final/` 이 내용을 설명한다고 해서 `source/` 를 지우지 않는다. exact snapshot을 다른 durable artifact로 옮기고 hash까지 고정한 경우에만 제거할 수 있다. `source/.source-revision`의 commit은 **import 당시 HEAD**이지 반입 바이트의 exact revision이라는 뜻이 아니다.