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, que escriben ingenieros y escritores técnicos. 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 la documentación generada a partir de los comentarios de código. No puedes hacer 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 fuente se duplican en el 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 y cambios sugeridos, y los propietarios de la documentación de Bazel harán la actualización.
Cambios significativos
Si quieres 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.