docs(readme): 미출시 범위를 한 번에 받는 명령과 기준점 기록을 적는다

문제
README "Updating a copied project"는 미출시 절을 한 범위로 받으라고 하면서
명령은 커밋 하나의 cherry-pick과 git diff뿐이다. 두 다운스트림이 실제로
쓰는 범위 merge(memento, 이력 공유)와 3-way 이식(tech-log, 이력 없음)은
없다. 기준점 기록도 .template-origin 하나만 적고, tech-log의
template.lock.json은 CHANGELOG에만 있다(0929/14-02 잔여).

고른 방법
- 범위를 받는 두 길을 명령과 함께 적었다: 이력을 공유하면 범위 브랜치를
  `git merge --no-ff`, 아니면 범위 기준점을 base로 둔 3-way 병합
  `git merge-recursive <range base> -- HEAD template/<range branch>`(tech-log가
  2026-09-29 동기화에 쓴 명령, 그 repo의 template-sync-2026-09-29.md).
- 기준점은 .template-origin이나 제품의 lock 파일(tech-log의
  template.lock.json sourceRevision)에 두고, 범위를 받은 뒤 범위 끝으로
  옮긴다고 적었다.
- 버린 대안: 동기화 스크립트를 템플릿에 두기. 두 제품의 방식이 달라
  설계가 필요하다.

위험·한계
- 명령을 이 커밋에서 실행해 보지 않았다. 두 다운스트림이 지난 동기화에 쓴
  명령을 옮겨 적었다(memento: git merge --no-ff, tech-log: git
  merge-recursive). 충돌 처리 안내는 없다.

검증
- desktop batch에서 확인: corepack pnpm verify:documentation

Refs: 0929/14-02
This commit is contained in:
DongHyeonka
2026-11-06 02:59:02 +09:00
parent 1ac336a72a
commit 57e3586292
+14
View File
@@ -393,6 +393,20 @@ git log --oneline <your origin>..template/main # what changed since you copied
git cherry-pick -x <commit> # one fix; -x records its origin
```
Take an unreleased range as a whole. A repository that shares the template's
history merges the range's branch. One that does not (it started from a copy
of the files) merges three-way against the range base, which leaves the files
both sides changed as conflicts; resolve them and commit:
```bash
git merge --no-ff template/<range branch> # shared history
git merge-recursive <range base> -- HEAD template/<range branch> # no shared history
```
Keep the base you synced from where your project records it: `.template-origin`
(below), or your own lock file (tech-log keeps it as `sourceRevision` in
`template.lock.json`). Move it to the range end once the range is in.
When the files have moved or diverged too far for a clean pick, read the
change as a diff and apply it by hand: