Bazel의 문서에 도움을 주셔서 감사합니다. 커뮤니티를 위한 더 나은 문서를 만드는 데 도움이 되는 몇 가지 방법이 있습니다.
문서 유형
이 사이트에는 몇 가지 유형의 콘텐츠가 포함되어 있습니다.
- 서술 문서: 기술 작성자 및 엔지니어가 작성합니다. 이 사이트의 대부분은 개념 가이드 및 작업 기반 가이드를 다루는 서술형 문서입니다.
- 참조 문서: 코드 주석에서 생성된 문서입니다. 참조 문서 페이지를 직접 변경할 수는 없지만 대신 소스를 변경해야 합니다.
문서 인프라
Bazel 문서는 Google에서 제공되며 소스 파일은 Bazel의 GitHub 저장소에 미러링됩니다. GitHub에서 소스 파일을 변경할 수 있습니다. 승인되면 변경사항을 병합할 수 있으며 Bazel 유지관리 담당자가 웹사이트 소스를 업데이트하여 업데이트를 게시합니다.
작은 변화
오류나 오타 수정과 같은 작은 변경에는 여러 가지 방법이 있습니다.
- pull 요청. 웹 기반 편집기를 사용하거나 브랜치를 사용하여 GitHub에서 pull 요청을 만들 수 있습니다.
- 버그. 세부정보와 권장 변경사항이 포함된 버그를 신고할 수 있으며, Bazel 문서 소유자가 업데이트할 것입니다.
큰 변화
기존 문서를 대폭 변경하거나 새 문서를 제안하려면 pull 요청을 만들거나 Google 문서로 시작한 후 Bazel 소유자에게 연락하여 협업할 수 있습니다.