Gracias por contribuir a la documentación de Bazel. Hay varias maneras 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 ingenieros y escritores técnicos 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 cambiar su fuente.
Infraestructura de la documentación
Google entrega la documentación de Bazel y los archivos fuente se duplican en el 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á la fuente del sitio web para publicar tus actualizaciones.
Cambios pequeños
Puedes abordar cambios pequeños, como corregir errores o errores tipográficos, de dos 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 y cambios sugeridos, y los propietarios de la documentación de Bazel realizarán la actualización.
Cambios grandes
Si deseas realizar cambios sustanciales en la documentación existente o proponer una nueva, puedes crear una solicitud de extracción o comenzar con un documento de Google y comunicarte con los propietarios de Bazel para colaborar.