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