Docs: Fix broken Siso tips links in build instructions

MERGED2026docsfix
2026. 7. 25.jsy8315 프로필 이미지jsy8315

Chromium 문서의 macOS·Windows 빌드 안내에서 Siso tips 문서로 가는 링크가 깨져 있던 문제를 수정했습니다.

문제 설명

docs/mac_build_instructions.mddocs/windows_build_instructions.md에서 Siso tips 문서를 가리키는 링크가 동작하지 않았습니다.

See [Siso tips](../siso_tips.md) too.
  • 두 문서는 모두 docs/ 하위에 있고, 링크 대상인 siso_tips.md도 같은 디렉터리에 있음
  • ../ 때문에 링크가 docs/보다 한 단계 위인 저장소 루트를 가리킴
  • Gitiles에서 클릭하면 chromium/src/+/main/siso_tips.md로 이동해 NOT_FOUND 응답
  • 대상 파일 자체는 존재하며, 상대 경로의 깊이만 잘못된 상태

해결 내용

  1. 링크가 실제로 해석되는 경로와 대상 파일의 위치를 각각 확인해 원인을 경로 깊이 오류로 판정
  2. 두 파일에서 ../ 접두사만 제거
See [Siso tips](siso_tips.md) too.
  1. docs/ 전체에 동일한 유형의 링크가 더 있는지 확인해 수정 범위를 2건으로 한정
  2. 첫 기여이므로 AUTHORS에 이름과 이메일을 알파벳순으로 추가하고 같은 커밋에 포함

테스트 방법

  1. vpython3 tools/md_browser/md_browser.py로 로컬 렌더링 서버를 실행
  2. http://localhost:8080/docs/mac_build_instructions.md, http://localhost:8080/docs/windows_build_instructions.md에서 링크가 docs/siso_tips.md로 이동하는지 확인
  3. 수정 전후의 Gitiles 경로를 비교해 NOT_FOUND가 해소되는지 확인
  4. git cl upload 시 자동 실행되는 presubmit 통과 확인

배운 점

  • 마크다운 상대 경로는 문서가 위치한 디렉터리를 기준으로 해석되므로, 같은 디렉터리의 파일에는 ../를 붙이면 안 됩니다.
  • Chromium 도구는 스크립트 첫 줄의 shebang이 실행 방법을 지정합니다. md_browser.py#!/usr/bin/env vpython3이며, python3로 실행하면 의존성을 찾지 못해 실패합니다.
  • Gerrit 인증은 git cl creds-check로 설정만 되고, 실제 로그인은 git credential-luci login을 따로 실행해야 합니다.
  • 리뷰어는 해당 파일의 수정 이력에서 반복적으로 등장하는 리뷰어를 찾아 지정하는 것이 효과적이었습니다.
  • 기여 전반 과정을 빠르게 경험할 수 있어 좋았습니다.

참고 자료