Gracias por contribuir a la documentación de Bazel. Hay 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 ingenieros y redactores 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 documentación generada a partir de comentarios de código. No puedes realizar cambios directamente en las páginas de documentos de referencia, sino que necesitas cambiar su fuente.
Infraestructura de documentación
La documentación de Bazel se entrega desde Google, y los archivos fuente se replican en el repositorio de GitHub de Bazel. Puedes realizar cambios en los archivos fuente de GitHub. Si se aprueban, puedes combinar los cambios, y un mantenedor 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 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.