O Bazel hospeda grupos de interesse especial (SIGs) 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 a 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 no 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 ter evidências suficientes de que há membros da comunidade dispostos a se envolver 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 o SIG.
Confira a lista completa de SIGs do Bazel.
Não são metas: o que um SIG não é
O objetivo dos SIGs é facilitar a colaboração em trabalhos compartilhados. Um SIG é, portanto:
- 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.
- Trabalho não sem custo financeiro:é necessária 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 fazer a colaboração sem precisar de um SIG.
Ciclo de vida do SIG
Esta seção aborda como criar um SIG.
Pesquisa e consulta
Para propor um novo grupo de SIG, primeiro colete evidências para aprovação, conforme especificado abaixo. Algumas possibilidades são:
- Um problema ou conjunto de problemas bem definidos que o grupo resolveria
- Consulta com os membros da comunidade que seriam beneficiados, avaliando o benefício e a disposição deles para se comprometer
- Para projetos existentes, evidências de problemas e PRs que mostram que os colaboradores se importam com o tópico
- Possíveis metas 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. Em particular, ele precisa demonstrar:
- Um propósito e benefício claros para o Bazel (em um subprojeto ou área de aplicativo)
- Dois ou mais colaboradores dispostos a atuar como líderes de grupo, a 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 ao público. Um SIG pode reutilizar uma das listas públicas, como bazel-discuss, pedir uma lista para @bazel.build ou criar uma lista própria.
- Recursos que o SIG inicialmente exige (geralmente, lista de e-mails e videochamada regular).
- Os SIGs podem exibir documentos e arquivos do diretório em
bazelbuild/communityou do próprio repositório na organização do GitHubbazelbuild. Os SIGs podem vincular recursos externos se optarem por organizar o trabalho fora da organização do GitHubbazelbuild. - Os proprietários do Bazel aprovam ou rejeitam as solicitaçõ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.
A solicitação formal para o novo grupo é feita enviando uma carta como um PR para
bazelbuild/community
e incluindo a solicitação nos comentários do PR seguindo o modelo
abaixo. Após a aprovação, a solicitação de confirmação de recebimento do grupo é mesclada e os recursos necessários
são criados.
Modelo de solicitação de novo SIG
Para solicitar um novo SIG, use o modelo no repositório da comunidade: SIG-request-template.md.
Afretamento
Para estabelecer um grupo, você precisa de uma carta e precisa 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, aguardando a aprovação do administrador do grupo.
A carta precisa nomear um administrador. Além de um administrador, o grupo precisa 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 do Bazel.
Os criadores de grupos precisam postar o documento 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 suas 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 escolher usar a colaboração por meio de chamadas de conferência programadas ou canais de chat para realizar reuniões. Todas essas reuniões precisam ser anunciadas na lista de e-mails e as notas postadas na lista de e-mails depois. Reuniões regulares ajudam a aumentar a responsabilidade e o progresso em um SIG.
Os membros da equipe de produtos do Bazel podem monitorar e incentivar o grupo a discutir e agir de forma proativa.
Iniciar um SIG
Atividades obrigatórias:
- Notifique os grupos de discussão gerais do Bazel (bazel-discuss, bazel-dev).
Atividades opcionais:
- Criar uma postagem do 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 às vezes pedem ao líder do SIG que informe sobre o trabalho do SIG para 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 a operação. A equipe de produtos do Bazel se reserva o direito de arquivar SIGs inativos para manter a integridade geral do projeto, embora esse seja um resultado menos desejável. Um SIG também pode optar por se dissolver se reconhecer que atingiu o fim da vida útil.
Observação
Este conteúdo foi adotado do manual de SIGs do TensorFlow com modificações.