Grupos de interesse especiais do Bazel

Informar um problema Ver código-fonte

O Bazel hospeda grupos de interesses especiais (SIGs, na sigla em inglês) para focar 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 a bazelbuild.

Os SIGs trabalham publicamente. 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 governo, é preciso que haja provas suficientes de que há membros da comunidade dispostos a interagir e contribuir com o grupo de interesse. Antes de participar, 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.

Veja a lista completa do SIG do Bazel (em inglês).

Sem metas: o que não é um SIG

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

  • Não é um fórum de suporte: uma lista de e-mails e um SIG não são a mesma coisa.
  • Não é obrigatório imediatamente: logo no início da vida de um projeto, você pode não saber se compartilhou trabalhos ou colaboradores
  • Trabalho não livre de custos:a energia é necessária para o crescimento e a coordenação do trabalho.

Os proprietários do Bazel usam uma abordagem conservadora para a criação de SIG. Graças à facilidade de iniciar projetos no GitHub, há muitas maneiras de colaboração sem a necessidade de um SIG.

Ciclo de vida do SIG

Esta seção mostra como criar um SIG.

Pesquisa e consultoria

Para propor um novo grupo de SIG, primeiro colete evidências para aprovação, conforme especificado abaixo. Veja alguns caminhos possíveis:

  • Um problema bem definido ou um conjunto de problemas que o grupo resolveria
  • Consulta com membros da comunidade que seriam beneficiados, avaliando os benefícios e a disposição deles
  • Para projetos atuais, evidências de problemas e relações públicas que os colaboradores se preocupam com o tema
  • Possíveis metas para o grupo atingir
  • Requisitos do recurso para executar o grupo

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

Criar o novo grupo

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

  • Uma finalidade e benefício claros para o Bazel (em torno de um subprojeto ou área de aplicativo)
  • Dois ou mais colaboradores estão dispostos a atuar como líderes de 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 a própria lista
  • Recursos inicialmente exigidos pelo SIG (geralmente lista de e-mails e videochamada normal).
  • Os SIGs podem disponibilizar documentos e arquivos do próprio diretório em bazelbuild/community ou do próprio repositório na organização do bazelbuild no GitHub. Os SIGs podem vincular recursos externos se optarem por organizar o trabalho fora da organização bazelbuild do GitHub.
  • Os proprietários do Bazel aprovam ou rejeitam aplicativos SIG e consultam outras partes interessadas conforme necessário.

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

A solicitação formal do novo grupo é feita ao enviar um frete como PR para bazelbuild/community e incluir a solicitação nos comentários do 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 um novo SIG

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

Fretamento

Para estabelecer um grupo, você precisa de um frete e precisa 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, com aprovação pendente do administrador do grupo.

A licença precisa indicar um administrador. Além disso, como administrador, o grupo precisa incluir pelo menos uma pessoa como líder (que pode ser a mesma), que atua como ponto de contato para coordenação, conforme necessário, com a equipe de produto do Bazel.

Os criadores de conteúdo em grupo precisam postar o documento na lista de e-mails. O repositório da comunidade na organização do Bazel no GitHub arquiva esses documentos e políticas. À medida que os grupos aprimoram as práticas e convenções, eles precisam atualizar os fretamentos dentro da parte relevante do repositório da comunidade.

Colaboração e inclusão

Embora não seja obrigatório, o grupo precisa usar a colaboração em videoconferências programadas ou em canais de chat para fazer reuniões. Todas essas reuniões precisam ser divulgadas na lista de e-mails e as notas são postadas na lista de e-mails posteriormente. Reuniões regulares ajudam a gerar responsabilidade e progredir em um SIG.

Os membros da equipe do Bazel podem monitorar e incentivar o grupo a discutir e tomar medidas de maneira proativa.

Iniciar um SIG

Atividades necessárias:

Atividades opcionais:

  • Crie uma postagem para o blog do Bazel

Integridade e rescisão de SIGs

Os proprietários do Bazel se esforçam ao máximo para garantir a integridade dos SIGs. Os proprietários do Bazel costumam solicitar ocasionalmente que o líder do SIG informe o trabalho do SIG para informar a comunidade mais ampla sobre a atividade do grupo.

Se um SIG não tiver mais uma finalidade útil ou comunidade interessada, ele poderá ser arquivado e interromper a operação. A equipe de produto do Bazel reserva-se 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 abandonar se reconhecer que chegou ao fim da vida útil.

Observações

Esse conteúdo foi adotado no manual de SIG do Tensorflow com modificações.