작업지시-4차에 D 묶음(변경 이력 전용 폴더) 추가
690줄짜리 진행상황.md 를 doc/history/ 의 날짜별 파일과 changelog 로 나눈다. 기록하는 자리를 바꾸는 일이라 A~C 보다 먼저 하는 편이 낫다고 적었다.
This commit is contained in:
parent
c870eacfe8
commit
d82db6572b
@ -10,6 +10,7 @@
|
||||
## 공통 규칙
|
||||
|
||||
- **A → B → C 순서로 진행한다.** A 는 작업한 것이 사라지는 문제라 제일 먼저다.
|
||||
D(변경 이력 폴더)는 기록하는 자리를 바꾸는 일이라 **먼저 해 두는 편이 낫다** - 자세한 까닭은 D 묶음에 적었다.
|
||||
C(화면 구성)는 서로 얽히지 않아 순서를 바꿔도 되지만, 기능이 자리를 잡은 뒤에 손대는 편이 손이 덜 간다.
|
||||
- **항목 하나를 끝낼 때마다** 빌드하고 실제로 실행해 화면을 확인한 뒤 보고한다. 전부 끝내고 한 번에 보고하지 않는다.
|
||||
- 항목 하나가 끝나면 `doc/진행상황.md` 의 대기/진행/완료를 갱신하고 **로컬 커밋**한다. 커밋 메시지는 한국어 한 줄.
|
||||
@ -173,6 +174,58 @@ C 묶음은 서로 얽히지 않으므로 **어느 것부터 해도 된다.**
|
||||
|
||||
---
|
||||
|
||||
## D. 변경 이력을 전용 폴더로
|
||||
|
||||
**이 항목만 순서를 앞당겨도 된다.** 먼저 해 두면 A~C 의 기록이 처음부터 새 자리에 쌓인다.
|
||||
나중에 하면 옛 자리에 쌓아 뒀다가 다시 옮기게 된다.
|
||||
|
||||
### D-1. `doc/history/` 를 만들고 진행상황을 나눈다
|
||||
|
||||
- 지금 `doc/진행상황.md` 는 **690줄**이고 계속 늘어난다. 한 파일에 다섯 가지가 섞여 있다 -
|
||||
주차 목표 · 차수별 상태 표 · 항목별 상세 설명 · 미룬 것 · 완료 기록.
|
||||
"3차 D-3 에서 무슨 판단을 했더라" 를 찾으려면 스크롤로 뒤져야 한다. 5차·6차가 쌓이면 더 나빠진다.
|
||||
- 플랫폼은 이미 나눠 두었다(`UbisamPlatform/doc/history/` 에 `changelog.md` + 날짜별 파일).
|
||||
**MergeHub 만 한 파일에 쌓고 있다.** 같은 방식으로 맞춘다.
|
||||
- 이렇게 나눈다.
|
||||
|
||||
```
|
||||
doc/
|
||||
진행상황.md 지금 무엇이 대기·진행·완료인지 (표와 링크만)
|
||||
작업지시/
|
||||
3차.md · 4차.md · 머지툴보강.md · 사용성보강.md
|
||||
history/
|
||||
changelog.md 한 줄 요약 표 (날짜 · 무엇을 왜 · 커밋)
|
||||
2026-09-08-2주차.md
|
||||
2026-09-09-3차.md
|
||||
```
|
||||
|
||||
- `진행상황.md` 에는 **지금 상태만** 남긴다. 끝난 차수의 상세 설명은 날짜별 파일로 옮기고 링크만 건다.
|
||||
- `changelog.md` 는 한 줄 요약 표다. **플랫폼 것과 성격이 다르다** - 플랫폼 changelog 의 핵심은
|
||||
"다른 소비 프로그램에 미치는 영향"인데, MergeHub 는 소비 프로그램이라 그럴 대상이 없다.
|
||||
여기서는 **무엇을 왜 바꿨는지**가 중심이다. 형식만 빌리고 내용 기준은 따로 잡는다.
|
||||
- 파일 이름은 플랫폼과 같게 `YYYY-MM-DD-주제.md`.
|
||||
- **링크를 깨뜨리지 않는다.** 지시서를 `doc/작업지시/` 로 옮기면 `진행상황.md` 와 다른 지시서 안의
|
||||
경로가 전부 바뀐다. 옮긴 뒤 문서 안의 링크를 모두 고치고, 고친 것을 보고에 적는다.
|
||||
옮기는 값이 링크 고치는 값보다 작다고 판단되면 **지시서는 그대로 두고 history 만 만들어도 된다** -
|
||||
그때는 그렇게 판단한 까닭을 적는다.
|
||||
- 옮길 때 **내용을 고쳐 쓰지 않는다.** 자리만 옮긴다. 다시 쓰면 그때 무슨 판단을 했는지가 흐려진다.
|
||||
줄바꿈 형식이 바뀌어 파일 전체가 바뀐 것처럼 보이지 않게 주의한다(4차 C 묶음 커밋에서 실제로 그랬다).
|
||||
- 코드를 건드리지 않으므로 빌드·검사에 영향이 없다. 그래도 **커밋 뒤 앱을 한 번 띄워 본다** -
|
||||
문서만 고쳤다고 생각했는데 아닌 경우가 있다.
|
||||
- **판정 기준**: `진행상황.md` 가 200줄 아래로 줄고 지금 대기·진행 중인 것이 한 화면에 들어온다.
|
||||
끝난 차수의 상세는 `changelog.md` 한 줄에서 링크 한 번으로 간다. 문서 안의 링크가 하나도 깨지지 않는다.
|
||||
|
||||
### D-2. 앞으로의 기록 규칙을 정한다
|
||||
|
||||
- D-1 을 하고 나면 **공통 규칙의 "진행상황.md 를 갱신한다" 가 뜻이 달라진다.** 새 규칙을 지시서 맨 앞에 적는다.
|
||||
- 항목을 끝내면 **상세는 그 날짜 파일**(`doc/history/YYYY-MM-DD-주제.md`)에 적는다.
|
||||
- `진행상황.md` 는 **대기 → 완료로 상태만** 고친다.
|
||||
- `changelog.md` 에 한 줄을 더한다 - 날짜 · 무엇을 왜 · 커밋 해시.
|
||||
- 지금까지 상세를 진행상황에 몰아 적은 것은 파일이 하나뿐이어서였다. 자리가 생기면 나눌 이유가 생긴다.
|
||||
- **판정 기준**: 4차 A~C 를 진행하는 동안 이 규칙대로 기록이 쌓이고, 진행상황이 다시 길어지지 않는다.
|
||||
|
||||
---
|
||||
|
||||
## 이번 지시서에서 하지 않는 것
|
||||
|
||||
번호를 붙여 두는 이유는 나중에 "왜 안 했나" 를 다시 묻지 않기 위해서다.
|
||||
|
||||
@ -684,6 +684,13 @@ System.ArgumentException
|
||||
| 대기 | C-4 색 구분 범례를 이동 도구로 |
|
||||
| 대기 | C-5 ACTIONS 칸을 자주 쓰는 것과 한 번 정하는 것으로 나눈다 |
|
||||
|
||||
### D. 변경 이력을 전용 폴더로
|
||||
|
||||
| 상태 | 항목 |
|
||||
|---|---|
|
||||
| 대기 | D-1 `doc/history/` 를 만들고 진행상황을 나눈다 |
|
||||
| 대기 | D-2 앞으로의 기록 규칙을 정한다 |
|
||||
|
||||
---
|
||||
|
||||
## 3~4주차로 미룬 것
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user