Bazel aloja grupos de interés especiales (SIG) para enfocar la colaboración en tareas específicas
y para facilitar la comunicación y la coordinación entre los propietarios de Bazel,
encargados de mantenimiento y colaboradores. Esta política
se aplica a bazelbuild.
Los SIG hacen su trabajo en público. El alcance ideal de un SIG abarca un contexto bien definido
dominio, donde la mayor parte de la participación es de la comunidad. Los SIG pueden
se enfocan en repositorios mantenidos por la comunidad en bazelbuild (como el lenguaje
) ni enfocarte en las áreas de código del repositorio de Bazel (como los objetos
Ejecución).
Aunque no todos los SIG tendrán el mismo nivel de energía, amplitud de alcance o de modelos de administración de contenido, debe haber evidencia suficiente de que hay miembros que están dispuestos a participar y contribuir si el grupo de interés establecidos. Antes de unirte, revisa el trabajo del grupo y, luego, comunícate con el líder de SIG. Las políticas de membresía varían según la SIG.
Consulta la lista completa de SIG de Bazel.
No objetivos: Lo que no es un SIG
Los SIG están destinados a facilitar la colaboración en el trabajo compartido. Un SIG es por lo tanto:
- No es un foro de asistencia: una lista de distribución y un SIG no es lo mismo.
- No es necesaria de inmediato: Al principio de la vida de un proyecto, es posible que no sepas si compartiste trabajos o colaboradores
- Trabajo no libre: Se requiere energía para crecer y coordinar el trabajo. de forma colaborativa
Los propietarios de Bazel adoptan un enfoque conservador para la creación de SIG, gracias a la facilidad de para iniciar proyectos en GitHub, hay muchas vías donde la colaboración puede sin la necesidad de una SIG.
Ciclo de vida de SIG
En esta sección, se explica cómo crear un SIG.
Investigación y asesoramiento
Para proponer un nuevo grupo SIG, primero debes recopilar pruebas para su aprobación, según lo especificado. a continuación. Estas son algunas formas posibles de considerar:
- Problema bien definido o conjunto de problemas que el grupo resolvería
- Consultar con los miembros de la comunidad que se beneficiarían, en los que se evalúan beneficio y su voluntad de comprometerse
- Para proyectos existentes, pruebas de problemas y relaciones públicas que les interesan a los colaboradores sobre el tema
- Posibles objetivos del grupo para que los logre
- Requisitos de recursos para ejecutar el grupo
Incluso si la necesidad de una SIG parece evidente, la investigación y la consulta son importante para el éxito del grupo.
Crea el grupo nuevo
El nuevo grupo debe seguir el siguiente proceso para el estatuto. En particular, debe demostrar lo siguiente:
- Un propósito y beneficio claros para Bazel (ya sea en torno a un subproyecto o área de aplicación)
- Dos o más colaboradores dispuestos a actuar como líderes del grupo, existencia de otras colaboradores y evidencia de demanda para el grupo
- Cada grupo debe usar al menos una lista de distribución de acceso público. UN SIG puede reutilizar una de las listas públicas, como bazel-debate, solicita una lista para @bazel.build o crear su propia lista
- Los recursos que el SIG requiere inicialmente (por lo general, una lista de distribución y videollamada).
- Los SIG pueden entregar documentos y archivos de su directorio en
bazelbuild/communityo de su propio repositorio en labazelbuildGitHub para que se adapten a las necesidades de tu organización. Los SIG pueden vincularse a recursos externos si deciden organizar su trabajo fuera de la organización de GitHubbazelbuild - Los propietarios de Bazel aprueban o rechazan las aplicaciones de SIG y consultan a otros a los interesados según sea necesario
Antes de ingresar a las partes formales del proceso, debes consultar con al equipo de producto de Bazel en product@bazel.build. La mayoría de los SIG requieren una conversación e iteración antes de la aprobación.
La solicitud formal para el nuevo grupo se realiza con la presentación de un estatuto como RR.PP. a
bazelbuild/community,
e incluir la solicitud en los comentarios del comunicado de prensa según la plantilla.
a continuación. Tras la aprobación, se combina el PR del grupo y se agregan los recursos necesarios
crear.
Solicitud de plantilla para un SIG nuevo
Para solicitar un SIG nuevo, usa la plantilla del repositorio de la comunidad: SIG-request-template.md.
Arrendamiento
Para establecer un grupo, necesitas un estatuto y debes seguir la regla de Bazel. código de conducta. Los archivos del grupo serán públicos. La membresía puede estar abierta para todos sin aprobación, o disponible a pedido, pendiente de aprobación del grupo administrador.
El estatuto debe nominar a un administrador. Además de un administrador, debe incluir, al menos, una persona como líder (pueden ser la misma persona), que actúa como punto de contacto para la coordinación según lo requerido con la Bazel equipo de producto.
Los creadores del grupo deben publicar su estatuto en la lista de distribución del grupo. La comunidad en los archivos de la organización de GitHub de Bazel, como los documentos y políticas de seguridad. A medida que los grupos evolucionan en sus prácticas y convenciones, deben actualizar sus estatutos dentro de la parte relevante del repositorio de la comunidad.
Inclusión y colaboración
Si bien no es un mandato, el grupo debe optar por la colaboración a través de conferencias telefónicas programadas o canales de chat para realizar reuniones. Cualquiera las reuniones se deben anunciar en la lista de distribución y las notas se deben publicar lista de distribución. Las reuniones periódicas ayudan a impulsar la responsabilidad y el progreso de una SIG.
Los miembros del equipo de producto de Bazel pueden supervisar y alentar de manera proactiva al grupo a hacer lo siguiente: el debate y las acciones según corresponda.
Iniciar un SIG
Actividades obligatorias:
- Notificar a los grupos de discusión generales de Bazel (bazel-debate, bazel-dev).
Actividades opcionales:
- Crea una entrada para el blog de Bazel
Estado y rescisión de los SIG
Los propietarios de Bazel hacen todo lo posible para garantizar la salud de los SIG. Propietarios de Bazel pueden solicitar al líder de SIG que informe sobre el trabajo del SIG, para informar al toda la comunidad de Bazel de la actividad del grupo.
Si una SIG ya no tiene un propósito útil o una comunidad interesada, puede y cesar las operaciones. El equipo de producto de Bazel se reserva el derecho de archivar esos SIG inactivos para mantener el estado general del proyecto, aunque es un resultado menos preferible. Un SIG también puede optar por disolver si reconoce que llegó al final de su vida útil.
Nota
Este contenido se adoptó en el plan Guía de SIG con modificaciones.