이슈 링크

이슈 링크 정규화

GitHub에서는 Fixes #123과 같은 자동 동작을 사용할 수 있으며, 이 동작은 123번 이슈를 닫습니다. 이 핸들러는 풀 리퀘스트 설명을 정규화된 형태인 Fixes org/repo#123으로 갱신합니다.

이는 서브트리를 업스트림 저장소로 갱신할 때 유용합니다. 서브트리 쪽 이슈 대신 업스트림 저장소의 이슈를 참조하고 닫아 버리는 일을 막아 주기 때문입니다.

커밋 내 이슈 링크

GitHub에서는 커밋에도 이슈 링크를 넣을 수 있으며, 이렇게 넣은 링크는 해당 이슈에 참조로 표시됩니다. 유용하기는 하지만, 참조된 이슈를 스팸으로 도배하는 결과를 낳는 경우가 많습니다. 이 핸들러는 이러한 링크에 대해 경고를 표시합니다.

설정

이 기능은 triagebot.toml에 [issue-links] 테이블을 추가하면 해당 저장소에서 활성화됩니다:

[issue-links]

커밋 검사 없이 사용하기

일부 저장소에서는 커밋 메시지 내 이슈 링크에 대해 경고할 필요가 없거나, 경고하지 않는 편을 선호할 수 있습니다. 이 동작은 check-commits 설정 옵션으로 비활성화할 수 있습니다:

[issue-links]
check-commits = false # defaults to true

정규화되지 않은 이슈 링크만 검사하기

서브트리(또는 내장된 저장소)의 경우, 정규화되지 않은 이슈 링크(예: rust-lang/cargo#123 대신 #132)는 계속 검사할 것을 권장합니다. 이렇게 하면 커밋 내 이슈 링크는 계속 허용하면서도, 서브트리가 업스트림에 병합될 때 링크가 잘못된 저장소를 가리키는 일을 막을 수 있습니다.

[issue-links]
check-commits = "uncanonicalized" # for subtrees

구현

src/handlers/issue_links.rs 및 src/handlers/check_commits/issue_links.rs를 참조하십시오.