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 varios tipos de contenido.
- Documentación narrativa, escrita por redactores técnicos e 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 la documentación generada a partir de comentarios de 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 publica 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 aprueba, puedes combinar los cambios, y un mantenedor de Bazel actualizará el código fuente del sitio web para publicar tus actualizaciones.
Cambios menores
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 presentar un error con detalles y cambios sugeridos, y los propietarios de la documentación de Bazel realizarán la actualización.
Cambios importantes
Si quieres realizar cambios importantes 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.