From 6fa4f825f2ada0b64ee3945ad86349bc01111cf5 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 17:18:18 +0900 Subject: [PATCH] =?UTF-8?q?ci(links):=20=EA=B8=B0=EB=A1=9D=20=EC=95=88?= =?UTF-8?q?=EC=9D=98=20=EC=A3=BD=EC=9D=80=20=EC=99=B8=EB=B6=80=20=EB=A7=81?= =?UTF-8?q?=ED=81=AC=20=EB=84=B7=EC=9D=84=20lychee=20=EC=A0=9C=EC=99=B8=20?= =?UTF-8?q?=EB=AA=A9=EB=A1=9D=EC=97=90=20=EB=91=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: lychee가 기록 문서 안의 외부 링크 404 넷으로 실패한다(mongodb write-concern, aws credentials-chain `.html/`, aws SES SendEmail `.html/`, spring-graphql 1.3 request-execution). 넷 모두 `docs/design`·`docs/reviews` 안에 있고, 기록 본문은 고치지 않는다. 고른 방법: 저장소 루트에 `.lycheeignore`를 두고 그 네 URL만 `^…$`로 묶은 정규식으로 뺀다. lychee는 실행 위치의 `.lycheeignore`를 읽으므로 workflow를 고치지 않아도 된다. `scripts/check-repo-layout.py` 허용 목록에 이 파일을 더한다. 버린 대안: - `lychee.toml`의 `exclude_path`로 기록 폴더를 통째로 빼기. 기록 안 상대 링크까지 검사에서 빠진다. - workflow에 `--exclude` 인자 더하기. workflow는 CI 재편 작업이 고친다. 위험·한계: 같은 URL을 살아 있는 문서가 쓰면 거기서도 검사하지 않는다. 끝의 `/`가 없는 aws 두 URL은 살아 있어 빼지 않았다. 검증: `python3 scripts/check-repo-layout.py` rc=0. 정규식이 네 URL에만 맞고 `/` 없는 aws 두 URL에는 맞지 않는 것을 Python `re`로 확인했다. --- .lycheeignore | 13 +++++++++++++ scripts/check-repo-layout.py | 1 + 2 files changed, 14 insertions(+) create mode 100644 .lycheeignore diff --git a/.lycheeignore b/.lycheeignore new file mode 100644 index 00000000..82f08cd2 --- /dev/null +++ b/.lycheeignore @@ -0,0 +1,13 @@ +# lychee 링크 검사가 건너뛸 URL. 한 줄에 정규식 하나다. lychee가 저장소 루트에서 이 파일을 읽는다. +# 기록 문서 docs/design, docs/history, docs/reviews 안의 죽은 외부 링크만 여기에 더한다. +# 기록 본문은 고치지 않으니 링크 대신 이 목록을 고친다. 살아 있는 문서의 죽은 링크는 문서를 고친다. +# 규칙은 docs/README.md 문서 검사 절이다. + +# docs/design/2026-07-26-production-capability-platform-design.md +^https://www\.mongodb\.com/docs/manual/reference/write-concern/index\.html$ +# docs/design/2026-07-28-notification-production-capability-design.md +^https://docs\.aws\.amazon\.com/ses/latest/APIReference-V2/API_SendEmail\.html/$ +# docs/design/2026-07-28-notification-production-capability-design.md +^https://docs\.aws\.amazon\.com/sdk-for-java/latest/developer-guide/credentials-chain\.html/$ +# docs/reviews/2026-08-14-graphql-module-code-review.md +^https://docs\.spring\.io/spring-graphql/reference/1\.3/request-execution\.html$ diff --git a/scripts/check-repo-layout.py b/scripts/check-repo-layout.py index 805adb87..d05fb1b3 100755 --- a/scripts/check-repo-layout.py +++ b/scripts/check-repo-layout.py @@ -47,6 +47,7 @@ ROOT_ALLOWED = { # 파일 ".gitattributes": "Git 설정", ".gitignore": "Git 설정", + ".lycheeignore": "링크 검사(lychee)가 건너뛸 URL. lychee는 저장소 루트의 이 이름만 읽는다", ".tool-versions": "JDK 버전 고정", ".trivyignore.yaml": "취약점 검사 예외", "AGENTS.md": "규칙 정본",