BazelCon 2022 estará disponible del 16 al 17 de noviembre en Nueva York y en línea.
Regístrate hoy mismo

Grupos de interés especiales de Bazel

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Bazel aloja grupos de interés especial (SIG) para enfocarse en la colaboración en áreas particulares y respaldar la comunicación y 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 se pueden enfocar en repositorios mantenidos por la comunidad en bazelbuild (como las reglas de lenguajes) o 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 o alcance de los modelos de control, debería 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 el SIG.

Consulta la lista completa de SIG de Bazel.

No objetivos: Qué no es un SIG

Los SIG están diseñados para facilitar la colaboración en el trabajo compartido. Por lo tanto, un SIG:

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

Los propietarios de Bazel adoptan un enfoque conservador para la creación de SIG. Gracias a la facilidad para iniciar proyectos en GitHub, existen muchas vías en las que la colaboración puede ocurrir sin la necesidad de un SIG.

Ciclo de vida de SIG

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

Investigación y consultas

A fin de proponer un nuevo grupo de SIG, primero debes recopilar la evidencia para su aprobación, como se especifica a continuación. Estas son algunas opciones que puedes considerar:

  • Un problema bien definido o un conjunto de problemas que el grupo podría resolver
  • Asesoramiento a miembros de la comunidad que se beneficiarían, evaluando el beneficio y la disposición a comprometerse
  • En el caso de los proyectos existentes, evidencia de problemas y RR.PP. que los colaboradores se preocupan por el tema
  • Objetivos potenciales que debe alcanzar el grupo
  • Requisitos de recursos para ejecutar 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 nuevo grupo

El nuevo grupo debe seguir el proceso que se describe a continuación para el registro. En particular, debe demostrar lo siguiente:

  • Un propósito y beneficio claros para Bazel (ya sea en torno a un subproyecto o al área de la aplicación)
  • Dos o más colaboradores dispuestos a actuar como líderes de grupos, existencia de otros colaboradores y evidencia de 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-analyze, solicitar una lista para @bazel.build o crear su propia lista
  • Recursos que requiere inicialmente 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 vincular a recursos externos si deciden organizar su trabajo fuera de la organización bazelbuild de GitHub.
  • Los propietarios de Bazel aprueban o rechazan las solicitudes SIG y consultan a otras partes interesadas según sea necesario

Antes de ingresar 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 y una iteración antes de la aprobación.

La solicitud formal para el nuevo grupo se realiza mediante el envío de una carta de RR.PP. a bazelbuild/community y la solicitud se incluye en los comentarios de la solicitud de RR.PP. que se encuentra en la plantilla a continuación. Cuando se aprueba, se combina la PR del grupo y se crean los recursos necesarios.

Solicitud de plantilla para un nuevo SIG

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

Chárter

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 a todos los usuarios sin aprobación o está disponible a pedido, con aprobación pendiente 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 (puede ser la misma persona) que actúa como punto de contacto para la coordinación según sea necesario con el equipo de productos de Bazel.

Los creadores de los grupos deben publicar la carta de la lista en la lista de distribución del grupo. El repositorio de la comunidad de 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 un requisito, el grupo debe optar por usar la colaboración a través de llamadas en conferencia programadas o canales de chat para llevar a cabo reuniones. Estas reuniones deben anunciarse en la lista de distribución, y las notas se deben publicar posteriormente en la lista. 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 y alentar de manera proactiva al grupo a debatir y tomar medidas según corresponda.

Iniciar un SIG

Actividades obligatorias:

Actividades opcionales:

  • Cree una entrada de blog para el blog de Bazel

Estado y rescisión de los SIG

Los propietarios de Bazel hacen todo lo posible para garantizar el buen estado de los SIG. En ocasiones, los propietarios de Bazel solicitan al jefe de SIG que informe sobre el trabajo de SIG para informar a la comunidad de Bazel más amplia de la actividad del grupo.

Si un 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 los SIG inactivos para mantener el estado general del proyecto, aunque es un resultado menos preferible. Es posible que un SIG decida discontinuarse si reconoce que llegó al final de su vida útil.

Nota

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