O Bazel hospeda grupos de interesse especial (SIGs, na sigla em inglês) para concentrar a colaboração em áreas específicas e apoiar a comunicação e a coordenação entre proprietários, mantenedores e colaboradores do Bazel. Esta política se aplica ao bazelbuild.
Os SIGs trabalham em público. O escopo ideal para um SIG abrange um domínio bem definido, em que a maioria 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 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 participar, analise o trabalho do grupo e entre em contato com o líder do SIG. As políticas de associação variam de acordo com cada SIG.
Confira a lista completa de SIGs do Bazel.
O que um SIG não é
Os SIGs foram criados para 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 é necessário imediatamente:no início de um projeto, talvez você não saiba se tem trabalho compartilhado ou colaboradores.
- Não é trabalho sem custo financeiro:é necessário energia para crescer e coordenar o trabalho de forma colaborativa.
Os proprietários do Bazel adotam uma abordagem conservadora para a criação de SIGs. Graças à facilidade de iniciar projetos no GitHub, há muitas maneiras de colaborar sem a necessidade de um SIG.
Ciclo de vida do SIG
Nesta seção, explicamos como criar um SIG.
Pesquisa e consultoria
Para propor um novo grupo de SIG, primeiro reúna evidências para aprovação, conforme especificado abaixo. Algumas opções a serem consideradas:
- Um problema ou conjunto de problemas bem definidos que o grupo resolveria
- Consulta com membros da comunidade que seriam beneficiados, avaliando o benefício e a disposição deles em participar
- Para projetos atuais, evidências de problemas e solicitações de pull que mostram que os colaboradores se importam com o tema
- Metas potenciais para o grupo alcançar
- Requisitos de recursos para executar o grupo
Mesmo que a necessidade de um SIG pareça óbvia, a pesquisa e a consulta ainda são importantes para o sucesso do grupo.
Criar o novo grupo
O novo grupo precisa seguir o processo abaixo para a criação da carta de princípios. Em particular, ele precisa demonstrar:
- Um propósito e um 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ências de demanda pelo grupo
- Cada grupo precisa usar pelo menos uma lista de e-mails acessível ao público. Um SIG pode reutilizar uma das listas públicas, como bazel-discuss, pedir uma lista para @bazel.build ou criar a própria lista.
- Recursos que o SIG exige inicialmente (geralmente, lista de e-mails e videochamada regular).
- Os SIGs podem disponibilizar documentos e arquivos do diretório em
bazelbuild/communityou do próprio repositório na organizaçãobazelbuilddo GitHub. Os SIGs podem vincular recursos externos se decidirem organizar o trabalho fora da organização do GitHubbazelbuild. - Os proprietários do Bazel aprovam ou rejeitam as inscrições de SIG e consultam outras partes interessadas conforme necessário.
Antes de entrar nas partes formais do processo, consulte a equipe de produtos do Bazel em product@bazel.build. A maioria dos SIGs exige conversa e iteração antes da aprovação.
O pedido formal para o novo grupo é feito enviando uma carta como uma solicitação de pull (PR, na sigla em inglês) para
bazelbuild/community,
e incluindo o pedido nos comentários da PR seguindo o modelo
abaixo. Após a aprovação, o PR do grupo é mesclado e os recursos necessários são criados.
Modelo de solicitação para um 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 uma carta de princípios e seguir o código de conduta do Bazel. Os arquivos do grupo serão públicos. A participação pode ser aberta a todos sem aprovação ou disponível mediante solicitação, pendente de aprovação do administrador do grupo.
A carta deve indicar um administrador. Além de um administrador, o grupo precisa incluir pelo menos uma pessoa como líder (podem ser a mesma pessoa), que serve como ponto de contato para coordenação, conforme necessário, com a equipe de produtos do Bazel.
Os criadores de grupos precisam postar a carta 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 as cartas na parte relevante do repositório da comunidade.
Colaboração e inclusão
Embora não seja obrigatório, o grupo deve usar a colaboração por videoconferências ou canais de chat para realizar reuniões. Essas reuniões precisam ser anunciadas na lista de e-mails, e as observações precisam ser postadas nela depois. Reuniões regulares ajudam a impulsionar a responsabilidade e o progresso em um SIG.
Os membros da equipe de produtos do Bazel podem monitorar proativamente e incentivar o grupo a discutir e tomar medidas conforme necessário.
Iniciar um SIG
Atividades obrigatórias:
- Notifique os grupos de discussão geral do Bazel (bazel-discuss, bazel-dev).
Atividades opcionais:
- Criar 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 dos SIGs. Os proprietários do Bazel ocasionalmente pedem ao líder do SIG para informar sobre o trabalho do SIG e informar a 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 encerrar as atividades. A equipe de produtos do Bazel se reserva o direito de arquivar esses SIGs inativos para manter a integridade geral do projeto, embora seja um resultado menos desejável. Um SIG também pode ser dissolvido se reconhecer que chegou ao fim da vida útil.
Observação
Este conteúdo foi adaptado do playbook do SIG do TensorFlow com modificações.