Grupos de interesse especial do Bazel

O Bazel hospeda grupos de interesse especiais (SIGs, na sigla em inglês) para concentrar a colaboração em áreas específicas e oferecer suporte à comunicação e coordenação entre proprietários, mantenedores e colaboradores do Bazel. Esta política se aplica ao bazelbuild.

Os SIGs fazem seu trabalho em público. O escopo ideal para um SIG abrange um domínio bem definido, em que a maior parte da participação é da comunidade. Os SIGs podem se concentrar em repositórios mantidos pela comunidade em bazelbuild (como regras de linguagem) ou em áreas de código no repositório do Bazel (como a execução remota).

Embora nem todos os SIGs tenham o mesmo nível de energia, amplitude de escopo ou modelos de governança, é preciso haver evidências suficientes de que há membros da comunidade dispostos a participar e contribuir caso o grupo de interesse seja estabelecido. Antes de entrar, revise o trabalho do grupo e entre em contato com o líder do SIG. As políticas de associação variam de acordo com o SIG.

Consulte a lista completa de SIGs do Bazel.

Não metas: o que é um SIG

O objetivo dos SIGs seja facilitar a colaboração em trabalhos compartilhados. Portanto, um SIG é:

  • Não é um fórum de suporte:uma lista de e-mails e SIG não são a mesma coisa.
  • Não é necessário imediatamente: no início de um projeto, você pode não saber se compartilhou trabalho ou colaboradores.
  • Não é mão de obra livre:é preciso energia para crescer e coordenar o trabalho de maneira colaborativa.

Os proprietários do Bazel seguem uma abordagem conservadora para a criação do SIG. graças à facilidade de iniciar projetos no GitHub, há muitos caminhos em que a colaboração pode acontecer sem a necessidade de um SIG.

Ciclo de vida da SIG

Esta seção mostra como criar um SIG.

Pesquisa e consultoria

Para propor um novo grupo SIG, primeiro reúna evidências para aprovação, conforme especificado abaixo. Alguns caminhos possíveis a serem considerados:

  • Um problema bem definido ou conjunto de problemas que o grupo resolveria
  • Consulta com membros da comunidade que se beneficiariam, avaliando tanto o benefício quanto a vontade de se comprometer
  • Para projetos existentes, evidências de problemas e PRs de que os colaboradores se preocupam com o tópico
  • Possíveis metas a serem alcançadas pelo grupo
  • Requisitos de recursos para executar o grupo

Mesmo que a necessidade de um SIG pareça evidente, a pesquisa e a consulta ainda são importantes para o sucesso do grupo.

Criar o novo grupo

O novo grupo deve seguir o processo abaixo para o termo de abertura. Especificamente, ele precisa demonstrar:

  • Um propósito e benefício claros para o Bazel, seja em torno de um subprojeto ou área de aplicativo.
  • Dois ou mais colaboradores dispostos a atuar como líderes do grupo, existência de outros colaboradores e evidências de demanda para o grupo
  • Cada grupo precisa usar pelo menos uma lista de e-mails acessível publicamente. Um SIG pode reutilizar uma das listas públicas, como bazel-discuss, solicitar uma lista para @bazel.build ou criar sua própria lista
  • Recursos que o SIG inicialmente exige (geralmente, lista de e-mails e videochamada normal).
  • Os SIGs podem exibir documentos e arquivos do diretório em bazelbuild/community ou do próprio repositório na organização bazelbuild do GitHub. Os SIGs podem se vincular a recursos externos se optarem por organizar o trabalho fora da organização bazelbuild do GitHub
  • Os proprietários do Bazel aprovam ou rejeitam aplicativos do SIG e consultam outras partes interessadas conforme necessário.

Antes de inserir as partes formais do processo, consulte a equipe de produtos do Bazel em product@bazel.build. A maioria das SIGs requer conversa e iteração antes da aprovação.

A solicitação formal para o novo grupo é feita enviando um termo de abertura como PR para bazelbuild/community e incluindo a solicitação nos comentários sobre o PR, seguindo o modelo abaixo. Após a aprovação, o PR do grupo é mesclado e os recursos necessários são criados.

Solicitação de modelo para novo SIG

Para solicitar um novo SIG, use o modelo disponível no repositório da comunidade: SIG-request-template.md.

Fretamento

Para estabelecer um grupo, você precisa de um termo de abertura e seguir o código de conduta do Bazel. Os arquivos do grupo serão públicos. A associação pode ser aberta a todos sem aprovação ou estar disponível mediante solicitação, aguardando aprovação do administrador do grupo.

O termo deve indicar um administrador. Além de um administrador, o grupo precisa incluir pelo menos uma pessoa como lead (pode ser a mesma pessoa), que serve como ponto de contato para coordenação, conforme exigido com a equipe de produto do Bazel.

Os criadores do grupo devem postar seu termo de abertura na lista de e-mails do grupo. O repositório da comunidade na organização do GitHub do Bazel arquiva esses documentos e políticas. À medida que os grupos evoluem as práticas e convenções, eles precisam atualizar os termos de abertura na parte relevante do repositório da comunidade.

Colaboração e inclusão

Embora isso não seja obrigatório, o grupo deve optar por usar a colaboração por meio de teleconferências programadas ou canais de chat para realizar reuniões. Essas reuniões devem ser anunciadas na lista de e-mails, e as notas devem ser postadas nessa lista posteriormente. Reuniões regulares ajudam a promover a responsabilidade e o progresso em um SIG.

Os membros da equipe de produto do Bazel podem monitorar e incentivar proativamente o grupo a discutir e agir conforme apropriado.

Iniciar um SIG

Atividades necessárias:

Atividades opcionais:

  • Criar uma postagem para o blog do Bazel

integridade e encerramento de SIGs

Os proprietários do Bazel se esforçam para garantir a integridade dos SIGs. Às vezes, os proprietários do Bazel solicitam que o líder do SIG informe o trabalho dele para informar à comunidade mais ampla do Bazel sobre a atividade do grupo.

Se um SIG não tiver mais uma finalidade útil ou uma comunidade interessada, ele poderá ser arquivado e interromper a operação. A equipe de produto do Bazel reserva o direito de arquivar esses SIGs inativos para manter a integridade geral do projeto, embora seja um resultado menos preferível. Um SIG também pode optar por cancelar a participação se reconhecer que chegou o fim da vida útil.

Observação

Este conteúdo foi adotado do manual do SIG (em inglês) do TensorFlow com modificações.