Gracias por contribuir a la documentación de Bazel. Existen varias formas de ayudar 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 basadas en 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 aprueban, puedes combinar los cambios, y un encargado de Bazel actualizará la fuente del sitio web para publicar tus actualizaciones.
Cambios pequeños
Puedes abordar los cambios pequeños, como corregir errores o errores tipográficos, de varias maneras.
- Solicitud de extracción. Puedes crear una solicitud de extracción en GitHub con el 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 importantes
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.