docs(work): 재배치 뒤에도 src/에서 Gradle을 돌리라는 절차를 고친다
문제: Gradle 루트를 저장소 루트로 옮긴 뒤(refactor(layout)!) src/에는 gradlew가 없다. 그런데 operate.md 4.1절 손 절차 두 곳은 아직 `cd ~/workspace/<작업 이름>/src` 다음 ./gradlew를 돌리라고 한다. desktop-gates 스킬 6단계가 단계 밖 명령(lane 하나, spotlessApply, 탐침)을 이 절차로 보내므로 그대로 따르면 명령이 없다고 실패한다. related-repos.md도 "Gradle 루트가 src/라 경로는 두 단계 위"라며 --include-build ../../messaging-library를 적는다. 지금은 workspace 밖을 가리킨다. 고른 방법: /src를 지우고, 라이브러리 경로를 한 단계 위(../messaging-library)로 고친다. 다른 살아 있는 문서에 같은 꼴(cd src, src/gradlew)이 남았는지 git grep으로 봤다. 시험 fixture(broken-readme.md)만 걸린다. 검증: python3 scripts/check-work-docs.py rc=0, check-docs.py rc=0.
This commit is contained in:
@@ -16,10 +16,10 @@
|
||||
## 2. 라이브러리를 고칠 때
|
||||
|
||||
- 템플릿 안에서 라이브러리 코드를 고치지 않는다. 라이브러리 repo에서 고치고 릴리스한다.
|
||||
- 템플릿 변경 때문에 라이브러리를 고쳐야 하면 두 repo에 브랜치를 하나씩 만들고, 두 repo를 같은 부모 폴더에 둔다(desktop은 `~/workspace/`). 템플릿에서 명령 줄로만 라이브러리를 끼워 같이 시험한다(composite build: Gradle이 같은 `group:artifact`의 외부 의존성을 끼운 빌드의 프로젝트로 바꿔 끼운다). Gradle 루트가 `src/`라 경로는 두 단계 위다.
|
||||
- 템플릿 변경 때문에 라이브러리를 고쳐야 하면 두 repo에 브랜치를 하나씩 만들고, 두 repo를 같은 부모 폴더에 둔다(desktop은 `~/workspace/`). 템플릿에서 명령 줄로만 라이브러리를 끼워 같이 시험한다(composite build: Gradle이 같은 `group:artifact`의 외부 의존성을 끼운 빌드의 프로젝트로 바꿔 끼운다). Gradle 루트가 저장소 루트라 경로는 한 단계 위다.
|
||||
|
||||
```bash
|
||||
./gradlew --include-build ../../messaging-library <태스크>
|
||||
./gradlew --include-build ../messaging-library <태스크>
|
||||
```
|
||||
|
||||
그 상태로 lockfile을 쓰거나 커밋하지 않는다. 끼운 모듈은 lockfile 밖으로 빠질 수 있다. 끼운 빌드는 자기 카탈로그로 컴파일되므로 라이브러리 repo CI 결과와 다를 수 있다. 최종 판정은 배포한 좌표로 돈 템플릿 게이트다.
|
||||
|
||||
Reference in New Issue
Block a user