Grupos de interés especiales de Bazel

Informa un problema Ver código fuente

Bazel aloja grupos de interés especiales (SIG) para enfocar la colaboración en áreas específicas y admitir la comunicación y la coordinación entre propietarios, encargados de mantenimiento y colaboradores de Bazel. Esta política se aplica a bazelbuild.

Las SIG trabajan en público. El alcance ideal de una SIG abarca un dominio bien definido, en el que la mayor parte de la participación es de la comunidad. Los SIG pueden enfocarse en repositorios mantenidos por la comunidad en bazelbuild (como las reglas de lenguaje) o en áreas de código del repositorio de Bazel (como Remote Execution).

Si bien no todos los SIG tendrán el mismo nivel de energía, alcance o modelos de Gobierno, debe haber evidencia suficiente de que hay miembros de la comunidad dispuestos a participar y contribuir si se establece el grupo de intereses. 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.

Objetivos: Qué no es una SIG

El objetivo de las SIG es facilitar la colaboración en el trabajo compartido. Por lo tanto, una SIG es la siguiente:

  • No es un foro de asistencia: Una lista de distribución y una SIG no son lo mismo.
  • No se requiere de inmediato: al principio del proyecto, es posible que no sepas si has compartido trabajo o colaboradores.
  • Trabajo no gratuito: Se requiere energía para crecer y coordinar el trabajo en colaboración.

Los propietarios de Bazel adoptan un enfoque conservador con respecto a la creación de SIG. Gracias a la facilidad para comenzar proyectos en GitHub, hay muchas vías que pueden colaborar sin la necesidad de una SIG.

Ciclo de vida de la SIG

En esta sección, se explica cómo crear una SIG.

Investigación y consulta

A fin de proponer un nuevo grupo de SIG, primero recopila evidencia para su aprobación, como se especifica a continuación. Algunas vías posibles para tener en cuenta son:

  • Un problema bien definido o un conjunto de problemas que el grupo podría resolver
  • Consulta a los miembros de la comunidad que se beneficiarían, con la evaluación del beneficio y su disposición a comprometerse
  • Para proyectos existentes, evidencia de problemas y relaciones públicas que los colaboradores se preocupan por el tema
  • Objetivos potenciales que puede alcanzar el grupo
  • Requisitos de recursos para ejecutar el grupo

Incluso si la necesidad de una 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 proceso de asignación que se indica a continuación. En particular, debe demostrar lo siguiente:

  • Un propósito y un beneficio claros para Bazel (ya sea alrededor de un subproyecto o un área de aplicación)
  • Dos o más colaboradores dispuestos a actuar como líderes de grupo, existencia de otros colaboradores y evidencia de demanda para el grupo
  • Cada grupo debe usar, al menos, una lista de distribución de acceso público. Una SIG puede reutilizar una de las listas públicas, como bazel-discuss, pedir una lista para @bazel.build o crear su propia lista.
  • Recursos que requiere inicialmente la SIG (por lo general, una lista de distribución y una videollamada normal)
  • Los SIG pueden entregar documentos y archivos desde su directorio en bazelbuild/community o desde su propio repositorio en la organización de GitHub bazelbuild. Los SIG pueden vincularse con recursos externos si eligen organizar su trabajo fuera de la organización bazelbuild de GitHub.
  • Los propietarios de Bazel aprueban o rechazan las aplicaciones SIG y consultan a otras partes interesadas según sea necesario

Antes de ingresar las partes formales del proceso, debes consultar con el equipo de productos de Bazel, en product@bazel.build. La mayoría de los SIG requieren conversación y, luego, iteración antes de la aprobación.

La solicitud formal del nuevo grupo se realiza mediante el envío de una carta de RR.PP. a bazelbuild/community y la solicitud en los comentarios de la solicitud de extracción que sigue la plantilla que se muestra a continuación. En la aprobación, se combina la solicitud de extracción del grupo y se crean los recursos necesarios.

Solicitud de plantilla para una nueva SIG

Para solicitar una SIG nueva, usa la plantilla en el repositorio de la comunidad: SIG-request-template.md.

Chárter

Para establecer un grupo, necesitas una carta y debes seguir el código de conducta de Bazel. Los archivos del grupo serán públicos. Es posible que la membresía esté abierta para todos sin aprobación o que se encuentre disponible a pedido y esté pendiente de la aprobación del administrador del grupo.

El estatuto debe nominar a un administrador. Además de un administrador, el grupo 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, como se requiere con el equipo del producto de Bazel.

Los creadores del grupo deben publicar la carta de registro 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 dentro de la parte relevante del repositorio de la comunidad.

Inclusión y colaboración

Si bien no es obligatorio, el grupo debe optar por usar la colaboración a través de conferencias programadas o canales de chat para realizar reuniones. Tales reuniones deben anunciarse en la lista de distribución, y las notas que se publiquen posteriormente en la lista de distribución. Las reuniones periódicas ayudan a impulsar la responsabilidad y el progreso en una SIG.

Los miembros del equipo de productos de Bazel pueden supervisar y animar al grupo a conversar de forma proactiva cuando corresponda.

Inicia una SIG

Actividades obligatorias:

Actividades opcionales:

  • Crear una entrada de blog para el blog de Bazel

Estado y rescisión de las SIG

Los propietarios de Bazel hacen su mejor esfuerzo para garantizar el buen funcionamiento de las SIG. Ocasionalmente, los propietarios de bazel solicitan al líder de SIG que informe sobre el trabajo de SIG para informar a la comunidad más amplia de Bazel sobre la actividad del grupo.

Si una SIG ya no tiene un propósito útil o una comunidad interesada, puede archivarse y dejar de funcionar. El equipo de productos de Bazel se reserva el derecho de archivar las SIG inactivas para mantener el estado general del proyecto, aunque es un resultado menos preferible. Una SIG también puede optar por discontinuar si reconoce que alcanzó el final de su vida útil.

Nota

Este contenido se adoptó de la guía de SIG de TensorFlow con modificaciones.