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 a bazelbuild.
Os SIGs fazem o trabalho deles 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, deve haver 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, revise o trabalho do grupo e entre em contato com o líder do SIG. As políticas de participação variam de acordo com o SIG.
Confira a lista completa de SIGs do Bazel.
Não metas: o que um SIG não é
Os SIGs têm como objetivo facilitar a colaboração no trabalho compartilhado. 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 da vida de um projeto, talvez você não saiba se tem trabalho compartilhado ou colaboradores
- Não é trabalho sem custo financeiro:é necessário energia para desenvolver 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
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 maneiras possíveis a serem consideradas são:
- Um problema ou conjunto de problemas bem definidos que o grupo resolveria
- Consulta com membros da comunidade que se beneficiariam, avaliando o benefício e a disposição deles em se comprometer
- Para projetos atuais, evidências de problemas e PRs 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 evidente, 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 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 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, 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 veicular documentos e arquivos do diretório deles em
bazelbuild/communityou do próprio repositório nabazelbuildGitHub organização. Os SIGs podem criar links para recursos externos se escolherem organizar o trabalho fora da organização do GitHubbazelbuild - Os proprietários do Bazel aprovam ou rejeitam aplicativos 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 dos SIGs exige conversa e iteração antes da aprovação.
A solicitação formal do 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, o PR do grupo é mesclado e os recursos necessários são criados.
Modelo de solicitação para novo SIG
Para solicitar um novo SIG, use o modelo no repositório da comunidade: SIG-request-template.md.
Criação
Para estabelecer um grupo, você precisa de uma carta e seguir o código de conduta do Bazel código de conduta. 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 precisa nomear 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 do grupo 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 precisa optar por usar a colaboração por meio de teleconferências ou canais de chat programados para realizar reuniões. Essas reuniões precisam ser anunciadas na lista de e-mails, e as observações postadas na lista de e-mails 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 e incentivar proativamente o grupo a discutir e agir conforme apropriado.
Iniciar um SIG
Atividades necessárias:
- Notificar os grupos de discussão geral do Bazel (bazel-discuss, bazel-dev).
Atividades opcionais:
- Criar uma postagem no blog do Bazel
Saúde e encerramento de SIGs
Os proprietários do Bazel fazem o possível para garantir a saúde dos SIGs. Os proprietários do Bazel ocasionalmente pedem ao líder do SIG para informar 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 um propósito útil ou uma comunidade interessada, ele poderá ser arquivado e interromper a operação. A equipe de produtos do Bazel reserva o direito de arquivar esses SIGs inativos para manter a saúde geral do projeto, embora seja um resultado menos preferível. Um SIG também pode optar por se dissolver se reconhecer que chegou ao fim da vida útil.
Observação
Este conteúdo foi adotado do manual do SIG do TensorFlow com modificações.