O Bazel hospeda grupos de interesse especiais (SIGs, na sigla em inglês) para concentrar 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 ao bazelbuild
.
Os SIGs fazem seu trabalho em público. 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 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 entrar, 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.
Consulte a lista completa de SIGs do Bazel.
Não metas: o que é um SIG
O objetivo dos SIGs seja facilitar a colaboração em trabalhos compartilhados. Portanto, um SIG é:
- Não é um fórum de suporte:uma lista de e-mails e SIG não são a mesma coisa.
- Não é necessário imediatamente: no início de um projeto, você pode não saber se compartilhou trabalho ou colaboradores.
- Não é mão de obra livre:é preciso energia para crescer e coordenar o trabalho de maneira colaborativa.
Os proprietários do Bazel seguem uma abordagem conservadora para a criação do SIG. graças à facilidade de iniciar projetos no GitHub, há muitos caminhos em que a colaboração pode acontecer sem a necessidade de um SIG.
Ciclo de vida da SIG
Esta seção mostra como criar um SIG.
Pesquisa e consultoria
Para propor um novo grupo SIG, primeiro reúna evidências para aprovação, conforme especificado abaixo. Alguns caminhos possíveis a serem considerados:
- Um problema bem definido ou conjunto de problemas que o grupo resolveria
- Consulta com membros da comunidade que se beneficiariam, avaliando tanto o benefício quanto a vontade de se comprometer
- Para projetos existentes, evidências de problemas e PRs de que os colaboradores se preocupam com o tópico
- 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 ainda são importantes para o sucesso do grupo.
Criar o novo grupo
O novo grupo deve seguir o processo abaixo para o termo de abertura. Especificamente, ele precisa demonstrar:
- Um propósito e benefício claros para o Bazel, seja em torno de um subprojeto ou área de aplicativo.
- Dois ou mais colaboradores dispostos a atuar como líderes do 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 sua própria lista
- Recursos que o SIG inicialmente exige (geralmente, lista de e-mails e videochamada normal).
- Os SIGs podem exibir documentos e arquivos do diretório em
bazelbuild/community
ou do próprio repositório na organizaçãobazelbuild
do GitHub. Os SIGs podem se vincular a recursos externos se optarem por organizar o trabalho fora da organizaçãobazelbuild
do GitHub - Os proprietários do Bazel aprovam ou rejeitam aplicativos do SIG e consultam outras partes interessadas conforme necessário.
Antes de inserir as partes formais do processo, consulte a equipe de produtos do Bazel em product@bazel.build. A maioria das 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 PR para
bazelbuild/community
e incluindo a solicitação nos comentários sobre o 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 novo SIG
Para solicitar um novo SIG, use o modelo disponível no repositório da comunidade: SIG-request-template.md.
Fretamento
Para estabelecer um grupo, você precisa de um termo de abertura e 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, aguardando aprovação do administrador do grupo.
O termo deve indicar um administrador. Além de um administrador, o grupo precisa incluir pelo menos uma pessoa como lead (pode ser a mesma pessoa), que serve como ponto de contato para coordenação, conforme exigido com a equipe de produto do Bazel.
Os criadores do grupo devem postar seu termo de abertura 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 os termos de abertura na 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 teleconferências programadas ou canais de chat para realizar reuniões. Essas reuniões devem ser anunciadas na lista de e-mails, e as notas devem ser postadas nessa lista posteriormente. Reuniões regulares ajudam a promover a responsabilidade e o progresso em um SIG.
Os membros da equipe de produto do Bazel podem monitorar e incentivar proativamente o grupo a discutir e agir conforme apropriado.
Iniciar um SIG
Atividades necessárias:
- Notifique os grupos de discussão gerais 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 se esforçam para garantir a integridade dos SIGs. Às vezes, os proprietários do Bazel solicitam que o líder do SIG informe o trabalho dele para informar à 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 interromper a operação. A equipe de produto do Bazel reserva 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 cancelar a participação se reconhecer que chegou o fim da vida útil.
Observação
Este conteúdo foi adotado do manual do SIG (em inglês) do TensorFlow com modificações.