Grupos de interesse especial do Bazel

Informar um problema Mostrar fonte Por noite · 7,3 · 7,2 · 7,1 · 7,0 · 6,5

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

Os SIGs fazem seu trabalho em público. O escopo ideal para um SIG abrange um conjunto em que a maior parte da participação é da comunidade. Os SIGs podem focam nos repositórios mantidos pela comunidade no bazelbuild (como ou focar em áreas de código no repositório do Bazel (como execução).

Embora nem todas as SIGs tenham o mesmo nível de energia, amplitude de escopo ou de governança, deve haver evidências suficientes de que há evidências membros dispostos a se envolver e contribuir, caso o grupo de interesse seja estabelecidos. Antes de entrar, analise o trabalho do grupo e entre em contato com o líder de SIG. As políticas de associação variam de acordo com o SIG.

Confira a lista completa SIGs do Bazel.

Sem metas: o que não é um SIG

As SIGs têm como objetivo facilitar a colaboração no trabalho compartilhado. Um SIG é Portanto:

  • Não é um fórum de suporte: uma lista de e-mails e um SIG não é a mesma coisa
  • Não é imediatamente necessário: no início de um projeto, você pode não saber se você compartilhou trabalhos ou colaboradores,
  • Mão de obra não livre: 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 iniciando projetos no GitHub, há muitos caminhos pelos quais a colaboração pode acontecer sem a necessidade de um SIG.

Ciclo de vida da SIG

Esta seção aborda como criar um SIG.

Pesquisa e consultoria

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

  • Um problema bem definido ou conjunto de problemas que o grupo resolveria
  • Consulta com membros da comunidade que se beneficiariam, avaliando ambos os benefício e sua disposição para se comprometer
  • Para projetos existentes, evidências de problemas e RPs que os colaboradores se importam sobre o assunto
  • 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 são ainda é importante para o sucesso do grupo.

Criar o novo grupo

O novo grupo deve seguir o processo de abertura abaixo. Especificamente, ela precisa 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 de grupo, a existência de outros colaboradores e evidências de demanda pelo 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, pedir uma lista para @bazel.build ou crie uma lista própria
  • Recursos que o SIG exige inicialmente (geralmente, lista de e-mails e videochamada.
  • Os SIGs podem fornecer documentos e arquivos de seus diretórios em bazelbuild/community ou dos próprios repositórios na bazelbuild GitHub organização. Os SIGs podem criar links para recursos externos se optarem por organizar o trabalho deles fora da organização bazelbuild do GitHub
  • Os proprietários do Bazel aprovam ou rejeitam aplicativos SIG e consultam outros às partes interessadas, conforme necessário

Antes de entrar nas partes formais do processo, consulte o com a equipe de produtos do 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 um termo de abertura como RP para bazelbuild/community, e inclua a solicitação nos comentários do RP seguindo o modelo a seguir. Após a aprovação, o RP do grupo é mesclado e os recursos necessários 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 criar um grupo, você precisa de um termo de abertura do projeto e precisa seguir o código de conduta. Os arquivos do grupo serão públicos. A assinatura pode ser aberta a todos sem aprovação ou disponível mediante solicitação, com aprovação pendente do grupo administrador.

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

Os criadores do grupo precisam postar o termo de abertura na lista de e-mails do grupo. Comunidade na organização do Bazel no GitHub arquiva esses documentos e políticas. À medida que os grupos evoluem suas práticas e convenções, eles devem atualizar os termos de abertura dentro da 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 conferências agendadas ou canais de chat para realizar reuniões. Qualquer um desses reuniões devem ser anunciadas na lista de e-mails e notas postadas na lista de e-mails no futuro. Reuniões regulares ajudam a promover a responsabilização e o progresso em um SIG.

Os membros da equipe de produto do Bazel podem monitorar e incentivar o grupo a discussão e ação conforme apropriado.

Iniciar uma SIG

Atividades necessárias:

Atividades opcionais:

  • Crie uma postagem para o blog do Bazel

Integridade e encerramento de SIGs

Os proprietários do Bazel fazem o possível para garantir a integridade das SIGs. Proprietários do Bazel ocasionalmente solicitam ao lead SIG que reportem o trabalho do SIG, para informar o mais ampla da comunidade do Bazel relacionada à atividade do grupo.

Se um SIG não tiver mais um propósito útil ou comunidade interessada, poderá ser arquivados e encerrar a operação. A equipe de produto do Bazel se reserva o direito de arquivar esses SIGs inativos para manter a integridade geral do projeto, embora seja um resultado menos preferível. O SIG também pode optar por se desfazer se ele reconhece que atingiu o fim de sua vida útil.

Observação

Este conteúdo foi adotado na arquitetura Manual do SIG com modificações.