Bazel alberga grupos de interés especial (SIG) para enfocar la colaboración en áreas particulares y respaldar la comunicación y la coordinación entre los propietarios, los mantenedores y los colaboradores de Bazel. Esta política se aplica a bazelbuild.
Los SIG realizan su trabajo de forma pública. El alcance ideal de un SIG abarca un dominio bien definido, en el que la mayoría de la participación proviene de la comunidad. Los SIG pueden enfocarse en repositorios mantenidos por la comunidad en bazelbuild (como reglas de lenguaje) o en áreas de código en el repositorio de Bazel (como la ejecución remota).
Si bien no todos los SIG tendrán el mismo nivel de energía, amplitud de alcance o modelos de gobernanza, debe haber evidencia suficiente de que hay miembros de la comunidad dispuestos a participar y contribuir si se establece el grupo de interés. Antes de unirte, revisa el trabajo del grupo y, luego, comunícate con el líder del SIG. Las políticas de membresía varían según el SIG.
Consulta la lista completa de los SIG de Bazel.
No objetivos: Qué no es un SIG
Los SIG tienen como objetivo facilitar la colaboración en el trabajo compartido. Por lo tanto, un SIG es lo siguiente:
- No es un foro de ayuda: Una lista de distribución y un SIG no son lo mismo
- No se requiere de inmediato: Al principio de un proyecto, es posible que no sepas si compartiste trabajo o si tienes colaboradores.
- No es trabajo gratuito: Se requiere energía para cultivar 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 con la que se pueden iniciar proyectos en GitHub, existen muchas vías para colaborar sin necesidad de un SIG.
Ciclo de vida del SIG
En esta sección, se explica cómo crear un SIG.
Investigación y asesoramiento
Para proponer un nuevo grupo de SIG, primero recopila evidencia para su aprobación, como se especifica a continuación. Estas son algunas opciones posibles que puedes considerar:
- Un problema o conjunto de problemas bien definidos que el grupo resolvería
- Consultas con los miembros de la comunidad que se beneficiarían, en las que se evalúa tanto el beneficio como su disposición a comprometerse
- En el caso de los proyectos existentes, evidencia de problemas y PR que demuestren que a los colaboradores les interesa el tema
- Objetivos potenciales que el grupo puede alcanzar
- Requisitos de recursos para administrar el grupo
Incluso si la necesidad de un SIG parece evidente, la investigación y la consulta siguen siendo importantes para el éxito del grupo.
Crea el grupo nuevo
El nuevo grupo debe seguir el proceso que se indica a continuación para obtener su estatuto. En particular, debe demostrar lo siguiente:
- Un propósito y un beneficio claros para Bazel (ya sea en torno a un subproyecto o un área de aplicación)
- Dos o más colaboradores dispuestos a actuar como líderes de grupo, la existencia de otros colaboradores y evidencia de la demanda del 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-discuss, solicitar una lista para @bazel.build o crear su propia lista.
- Recursos que el SIG requiere inicialmente (por lo general, una lista de distribución y una videollamada periódica)
- Los SIG pueden entregar documentos y archivos desde su directorio en
bazelbuild/communityo desde su propio repositorio en la organización de GitHubbazelbuild. Los SIG pueden vincularse a recursos externos si deciden organizar su trabajo fuera de la organización de GitHub debazelbuild. - Los propietarios de Bazel aprueban o rechazan las solicitudes de los SIG y consultan a otras partes interesadas según sea necesario.
Antes de ingresar a las partes formales del proceso, debes consultar al equipo de productos de Bazel en product@bazel.build. La mayoría de los SIG requieren conversación e iteración antes de la aprobación.
La solicitud formal para el nuevo grupo se realiza enviando una carta como PR a bazelbuild/community y, luego, incluyendo la solicitud en los comentarios de la PR según la siguiente plantilla. Una vez que se aprueba, se combina la PR del grupo y se crean los recursos necesarios.
Solicitud de plantilla para un SIG nuevo
Para solicitar un SIG nuevo, usa la plantilla del repo de la comunidad: SIG-request-template.md.
Alquiler de vuelos
Para establecer un grupo, necesitas una carta constitutiva y debes seguir el código de conducta de Bazel. Los archivos del grupo serán públicos. La membresía puede estar abierta a todos sin aprobación o estar disponible a pedido, pendiente de la aprobación del administrador del grupo.
La carta debe nominar a un administrador. Además de un administrador, el grupo debe incluir al menos a una persona como líder (puede ser la misma persona), que actuará como punto de contacto para la coordinación según sea necesario con el equipo de productos de Bazel.
Los creadores de grupos deben publicar su estatuto en la lista de distribución del grupo. El repositorio de la comunidad en la organización de GitHub de Bazel archiva esos documentos y políticas. A medida que los grupos evolucionan sus prácticas y convenciones, deben actualizar sus estatutos en la parte pertinente del repositorio de la comunidad.
Colaboración e inclusión
Si bien no es obligatorio, el grupo debe optar por usar la colaboración a través de llamadas en conferencia o canales de chat programados para llevar a cabo las reuniones. Cualquier reunión de este tipo se debe anunciar en la lista de distribución, y las notas se deben publicar en la lista de distribución después. Las reuniones periódicas ayudan a impulsar la responsabilidad y el progreso en un SIG.
Los miembros del equipo de productos de Bazel pueden supervisar de forma proactiva el grupo y fomentar el debate y la acción según corresponda.
Cómo lanzar un SIG
Actividades obligatorias:
- Notifica a los grupos de debate generales de Bazel (bazel-discuss, bazel-dev).
Actividades opcionales:
- Crea una entrada de blog para el blog de Bazel
Estado y finalización de los SIG
Los propietarios de Bazel hacen su mejor esfuerzo para garantizar el estado de los SIG. En ocasiones, los propietarios de Bazel solicitan al líder del SIG que informe sobre el trabajo del SIG para informar a la comunidad más amplia de Bazel sobre la actividad del grupo.
Si un SIG ya no tiene un propósito útil o una comunidad interesada, se puede archivar y dejar de funcionar. El equipo de productos de Bazel se reserva el derecho de archivar estos SIG inactivos para mantener la salud general del proyecto, aunque es un resultado menos deseable. Un SIG también puede optar por disolverse si reconoce que llegó al final de su vida útil.
Nota
Este contenido se adoptó del SIG playbook de TensorFlow con modificaciones.