Grupos de interés especial de Bazel

Informar un problema Ver fuente Noche {/2/}}

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

Los SIG hacen su trabajo en público. El alcance ideal de un 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 reglas de lenguaje) o enfocarse en áreas de código en el repositorio de Bazel (como Remote Execution).

Si bien no todos los SIG tendrán el mismo nivel de energía, amplitud de alcance o modelos de administración, 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 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. Por lo tanto, un SIG es:

  • No es un foro de asistencia: una lista de distribución y un SIG no es lo mismo.
  • No se requiere de inmediato: Al principio de la vida de un proyecto, es posible que no sepas si tienes colaboradores o trabajos compartidos.
  • Trabajo no libre: Se requiere energía para crecer y coordinar el trabajo de manera 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 la colaboración puede ocurrir 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 recopila pruebas para su aprobación, como se especifica 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, evaluar el beneficio y su voluntad de comprometerse
  • Para proyectos existentes, pruebas de problemas y RR.PP. que indiquen a los colaboradores que les interesa 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 siguen siendo importantes 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 un área de aplicación)
  • Dos o más colaboradores dispuestos a actuar como líderes del grupo, la existencia de otros colaboradores y la 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, solicitar una lista para @bazel.build o crear su propia lista
  • Recursos que la SIG requiere inicialmente (por lo general, una lista de distribución y una videollamada habitual).
  • 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 a recursos externos si deciden organizar su trabajo fuera de la organización de bazelbuild de GitHub.
  • Los propietarios de Bazel aprueban o rechazan las aplicaciones de 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 iteración y conversación antes de la aprobación.

La solicitud formal para un grupo nuevo se realiza mediante el envío de un estatuto como RR.PP. a bazelbuild/community y, luego, incluyendo la solicitud en los comentarios de RR.PP. según la siguiente plantilla. Después de la aprobación, se combina la solicitud de extracción del grupo y se crean los recursos necesarios.

Solicitud de plantilla para un SIG nuevo

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

Arrendamiento

Para establecer un grupo, necesitas un estatuto y debes seguir el código de conducta de Bazel. Los archivos del grupo serán públicos. La membresía puede estar abierta para todos sin aprobación o estar disponible a pedido, 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 cliente potencial (puede ser la misma persona) que actúe como punto de contacto para la coordinación según se requiera con el equipo de productos de Bazel.

Los creadores del grupo 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 estos 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. Dichas reuniones deben anunciarse en la lista de distribución y, luego, las notas deben publicarse en la lista de distribución. Las reuniones regulares ayudan a impulsar la responsabilidad y el progreso de una SIG.

Los miembros del equipo de productos de Bazel pueden supervisar de forma proactiva al grupo y alentarlo a debatir y tomar medidas según corresponda.

Iniciar un SIG

Actividades obligatorias:

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. Ocasionalmente, los propietarios de Bazel solicitan al líder de SIG que informe sobre el trabajo de SIG para que informe 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 cesar en funcionamiento. El equipo de productos de Bazel se reserva el derecho de archivar esos SIG inactivos para mantener el estado general del proyecto, aunque este 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ó a partir de la guía de SIG de TensorFlow con modificaciones.