Grupos de Interesse Especial Bazel

O Bazel hospeda Grupos de Interesse Especial (SIGs) para focar a colaboração em áreas específicas e para dar suporte à comunicação e coordenação entre proprietários, mantenedores e colaboradores do Bazel . Esta política se aplica ao bazelbuild .

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

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

Veja a lista completa de SIGs Bazel .

Não-objetivos: o que um SIG não é

Os SIGs destinam-se a facilitar a colaboração no trabalho compartilhado. Um SIG é, portanto:

  • Não é um fórum de suporte: uma lista de discussão e um SIG não são a mesma coisa
  • Não é necessário imediatamente: no início da vida de um projeto, você pode não saber se compartilhou trabalho ou colaboradores
  • Mão de obra não gratuita: energia é necessária para crescer e coordenar o trabalho de forma colaborativa

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

Ciclo de vida SIG

Esta seção aborda como criar um SIG.

Pesquisa e consulta

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

  • Um problema bem definido ou conjunto de problemas que o grupo resolveria
  • Consulta com os membros da comunidade que se beneficiariam, avaliando tanto o benefício quanto sua vontade de se comprometer
  • Para projetos existentes, evidências de problemas e PRs de que os contribuidores se preocupam com o tópico
  • Objetivos potenciais para o grupo alcançar
  • Requisitos de recursos para administrar 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 fretamento. Em particular, deve demonstrar:

  • Um propósito e benefício claros para o Bazel (em torno de um subprojeto ou área de aplicação)
  • Dois ou mais colaboradores dispostos a atuar como líderes do grupo, existência de outros colaboradores e evidência de demanda pelo grupo
  • Cada grupo precisa usar pelo menos uma lista de discussão publicamente acessível. 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 requer inicialmente (geralmente, lista de discussão e videochamada regular).
  • Os SIGs podem servir documentos e arquivos de seu diretório em bazelbuild/community ou de seu próprio repositório na organização bazelbuild GitHub. Os SIGs podem vincular a recursos externos se optarem por organizar seu trabalho fora da organização do GitHub do bazelbuild
  • Os proprietários do Bazel aprovam ou rejeitam as inscrições SIG e consultam outras partes interessadas conforme necessário

Antes de entrar nas partes formais do processo, você deve consultar a equipe do produto Bazel, em product@bazel.build. A maioria dos SIGs requer conversa e iteração antes da aprovação.

A solicitação formal para o novo grupo é feita enviando uma carta como PR para bazelbuild/community e incluindo a solicitação nos comentários sobre a PR seguindo o modelo abaixo. Na 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 no repositório da comunidade: SIG-request-template.md .

Fretamento

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

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

Os criadores do grupo devem postar sua carta na lista de discussão do grupo. O repositório da comunidade na organização do Bazel GitHub arquiva esses documentos e políticas. À medida que os grupos evoluem suas práticas e convenções, eles devem atualizar seus estatutos na parte relevante do repositório da comunidade.

Colaboração e inclusão

Embora não seja obrigatório, o grupo deve optar por fazer uso da colaboração por meio de teleconferências agendadas ou canais de bate-papo para realizar reuniões. Quaisquer reuniões desse tipo devem ser anunciadas na lista de discussão e as notas postadas na lista de discussão posteriormente. Reuniões regulares ajudam a impulsionar a responsabilidade e o progresso em um SIG.

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

Lançar um SIG

Atividades necessárias:

Atividades opcionais:

  • Criar uma postagem de blog para o blog do Bazel

Saúde 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 ocasionalmente solicitam ao líder do SIG que relate o trabalho do SIG, para informar a comunidade mais ampla do Bazel sobre a atividade do grupo.

Se um SIG não tiver mais um propósito útil ou comunidade interessada, ele poderá ser arquivado e deixar de funcionar. A equipe do produto Bazel reserva-se o direito de arquivar esses SIGs inativos para manter a integridade geral do projeto, embora seja um resultado menos preferível. Uma SIG também pode optar por dissolver se reconhecer que chegou ao fim de sua vida útil.

Observação

Este conteúdo foi adotado do manual SIG do Tensorflow com modificações.