Gracias por contribuir a la documentación de Bazel. Hay varias formas de para ayudarnos a crear mejores documentos para nuestra comunidad.
Tipos de documentación
Este sitio incluye algunos tipos de contenido.
- Documentación narrativa, escrita por escritores técnicos y ingenieros. La mayor parte de este sitio es documentación narrativa que abarca guías conceptuales y de tareas.
- Documentación de referencia, que es documentación que se genera a partir de comentarios del código. No puedes realizar cambios directamente en las páginas del documento de referencia; en su lugar, debes para cambiar su fuente.
Infraestructura de la documentación
Google entrega la documentación de Bazel y los archivos fuente se duplican. Repositorio de GitHub de Bazel. Puedes realizar cambios en los archivos fuente en GitHub. Si se aprueba, puedes combinar los cambios y un encargado de mantenimiento de Bazel actualizará el desde la fuente de tu sitio web para publicar tus actualizaciones.
Cambios pequeños
Puedes abordar cambios pequeños, como corregir errores o errores tipográficos, en un par de maneras.
- Solicitud de extracción. Puedes crear una solicitud de extracción en GitHub con el un editor basado en la Web o en una rama.
- Error. Puedes informar un error con detalles, cambios sugeridos y la API de Bazel. y los propietarios de la documentación la llevarán a cabo.
Cambios grandes
Si quieres realizar cambios sustanciales a documentación existente o proponer documentación nueva, puedes crear una solicitud de extracción y comunícate con los propietarios de Bazel para colaborar.