Grupos de interés especial de Bazel

Bazel alberga grupos de interés especial (SIG) para centrar la colaboración en áreas particulares y para apoyar la comunicación y la coordinación entre los propietarios, mantenedores y colaboradores de Bazel . Esta política se aplica a bazelbuild .

Los SIG hacen su trabajo en público. El alcance ideal para un SIG cubre un dominio bien definido, donde la mayoría de la participación es de la comunidad. Los SIG pueden centrarse en repositorios mantenidos por la comunidad en bazelbuild (como reglas de lenguaje) o centrarse en áreas de código en el repositorio de Bazel (como 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 suficiente evidencia de que hay miembros de la comunidad dispuestos a participar y contribuir en caso de que se establezca el grupo de interés. Antes de unirse, revise el trabajo del grupo y luego póngase en contacto con el líder SIG. Las políticas de membresía varían según el SIG.

Consulte la lista completa de los SIG de Bazel .

Sin 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 soporte: una lista de correo y un SIG no es lo mismo
  • No se requiere de inmediato: al principio de la vida de un proyecto, es posible que no sepa si ha compartido trabajo o colaboradores.
  • Mano de obra no gratuita: 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 iniciar proyectos en GitHub, hay muchas vías en las que se puede colaborar sin necesidad de un SIG.

Ciclo de vida SIG

Esta sección cubre cómo crear un SIG.

Investigación y consulta

Para proponer un nuevo grupo SIG, primero reúna evidencia para su aprobación, como se especifica a continuación. Algunas vías posibles a considerar son:

  • Un problema bien definido o un conjunto de problemas que el grupo resolvería
  • Consulta con los miembros de la comunidad que se beneficiarían, evaluando tanto el beneficio como su disposición a comprometerse
  • Para proyectos existentes, evidencia de problemas y relaciones públicas de que los colaboradores se preocupan por el tema.
  • Objetivos potenciales que el grupo debe alcanzar
  • Requerimientos de recursos para operar 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.

Crear el nuevo grupo

El nuevo grupo debe seguir el siguiente proceso para la constitución. En particular, debe demostrar:

  • Un propósito claro y un beneficio 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 otros colaboradores y evidencia de demanda para el grupo
  • Cada grupo necesita usar al menos una lista de correo 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 inicialmente requiere el SIG (por lo general, una lista de correo y una videollamada regular).
  • Los SIG pueden servir documentos y archivos desde su directorio en bazelbuild/community o desde su propio repositorio en la organización bazelbuild GitHub. Los SIG pueden vincularse a recursos externos si eligen organizar su trabajo fuera de la organización bazelbuild GitHub
  • Los propietarios de Bazel aprueban o rechazan las solicitudes SIG y consultan a otras partes interesadas según sea necesario

Antes de ingresar a las partes formales del proceso, debe consultar con el equipo de producto 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 RP a bazelbuild/community e incluyendo la solicitud en los comentarios sobre el RP siguiendo la plantilla a continuación. Tras la aprobación, el RP del grupo se fusiona y se crean los recursos necesarios.

Solicitud de plantilla para nuevo SIG

Para solicitar un nuevo SIG, use la plantilla en el repositorio de la comunidad: SIG-request-template.md .

fletamento

Para establecer un grupo, necesita una carta y debe 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 disponible a pedido, pendiente de la aprobación del administrador del grupo.

La carta debe nombrar un administrador. Además de un administrador, el grupo debe incluir al menos una persona como líder (puede ser la misma persona), que sirva como punto de contacto para la coordinación según sea necesario con el equipo de producto de Bazel.

Los creadores de grupos deben publicar su estatuto en la lista de correo del grupo. El repositorio de la comunidad en la organización Bazel GitHub archiva dichos documentos y políticas. A medida que los grupos evolucionan en sus prácticas y convenciones, deben actualizar sus estatutos en la parte correspondiente del repositorio de la comunidad.

Colaboración e inclusión

Si bien no es obligatorio, el grupo debe optar por hacer uso de la colaboración a través de conferencias telefónicas programadas o canales de chat para realizar reuniones. Cualquier reunión de este tipo debe anunciarse en la lista de correo y las notas deben publicarse en la lista de correo después. Las reuniones periódicas ayudan a impulsar la rendición de cuentas y el progreso en un SIG.

Los miembros del equipo de productos de Bazel pueden monitorear de manera proactiva y alentar al grupo a discutir y actuar según corresponda.

Lanzar un SIG

Actividades requeridas:

Actividades opcionales:

  • Crear una publicación de blog para el blog de Bazel

Sanidad y terminación de SIGs

Los propietarios de Bazel hacen todo lo posible para garantizar la salud de los SIG. Los propietarios de Bazel ocasionalmente solicitan al líder de SIG que informe sobre el trabajo del SIG, para informar a la comunidad de Bazel en general sobre la actividad del grupo.

Si un SIG ya no tiene un propósito útil o una comunidad interesada, puede ser archivado y dejar de operar. El equipo de productos de Bazel se reserva el derecho de archivar dichos SIG inactivos para mantener la salud general del proyecto, aunque es un resultado menos preferible. Un SIG también puede optar por disolverse si reconoce que ha llegado al final de su vida útil.

Nota

Este contenido se adoptó del libro de jugadas SIG de Tensorflow con modificaciones.