Gracias por colaborar con la documentación de Bazel. Hay algunas 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 ingenieros y escritores técnicos La mayor parte de este sitio contiene 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, sino que debes cambiar su fuente.
Infraestructura de documentación
La documentación de Bazel se entrega desde Google y los archivos de origen 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 las 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 documentación nueva, puedes crear una solicitud de extracción o comenzar con un documento de Google y comunicarte con los propietarios de Bazel para colaborar.