cartilha SIG

Escopo de um SIG

O TensorFlow hospeda Grupos de Interesse Especial (SIGs) para focar a colaboração em áreas específicas. SIGs fazem seu trabalho em público. Para participar e contribuir, 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 a SIG.

O escopo ideal para um SIG atende a um domínio bem definido, onde a maioria da participação é da comunidade. Além disso, deve haver evidências suficientes de que há membros da comunidade dispostos a se envolver e contribuir caso o grupo de interesse seja estabelecido.

Nem todos os SIGs terão o mesmo nível de energia, amplitude de escopo ou modelos de governança, portanto, espere alguma variabilidade.

Veja a lista completa de SIGs do TensorFlow .

Sem objetivos: o que um SIG não é

O objetivo dos SIGs é facilitar a colaboração no trabalho compartilhado. Um SIG é, portanto:

  • Não é um fórum de suporte : uma lista de discussão e um SIG não são a mesma coisa.
  • Não é necessário imediatamente : no início da vida de um projeto, você pode não saber se compartilhou trabalho ou colaboradores.
  • Mão de obra não gratuita : é necessária energia para crescer e coordenar o trabalho de forma colaborativa.

Nossa abordagem para a criação de SIG será conservadora – graças à facilidade de iniciar projetos no GitHub, há muitos caminhos onde a colaboração pode acontecer sem a necessidade de um SIG.

Ciclo de vida do SIG

Pesquisa e consulta

Os proponentes de grupos devem reunir evidências para aprovação, conforme especificado abaixo. Alguns caminhos possíveis a serem considerados são:

  • Um problema bem definido ou um conjunto de problemas que o grupo resolveria.
  • Consulta aos membros da comunidade que se beneficiariam, avaliando tanto o benefício quanto sua disposição de se comprometer.
  • Para projetos existentes, evidências de problemas e PRs de que os contribuidores 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.

Criando o novo grupo

O novo grupo deve seguir o processo abaixo para constituição. Em particular, deve demonstrar:

  • Um propósito claro e benefício para o TensorFlow (em torno de um subprojeto ou área de aplicação)
  • Dois ou mais colaboradores dispostos a atuar como líderes de grupo, existência de outros colaboradores e evidência de demanda para o grupo
  • Os recursos necessários inicialmente (geralmente, lista de discussão e chamada de videoconferência regular).

A aprovação do grupo se dará por decisão do TF Community Team, definido como sendo os mantenedores do projeto tensorflow/community. A equipe consultará outras partes interessadas conforme necessário.

Antes de entrar nas partes formais do processo, é aconselhável consultar a equipe da comunidade TensorFlow, community-team@tensorflow.org. É altamente provável que a conversa e a iteração sejam necessárias antes que a solicitação SIG esteja pronta.

A solicitação formal para o novo grupo é feita enviando uma carta como PR ao tensorflow/comunidade e incluindo a solicitação nos comentários do PR (veja o modelo abaixo). Após a aprovação, o PR do grupo será mesclado e os recursos necessários serão criados.

Solicitação de Modelo para Novo SIG

Este modelo estará disponível no repositório da comunidade: SIG-request-template.md .

Fretamento

Cada grupo será estabelecido com um regulamento e será regido pelo código de conduta do TensorFlow. Os arquivos do grupo serão públicos. A associação pode ser aberta a todos sem aprovação ou disponível mediante solicitação, dependendo da aprovação do administrador do grupo.

A carta deve nomear um administrador. Além de um administrador, o grupo deve incluir pelo menos uma pessoa como líder (pode ser a mesma pessoa), que servirá como ponto de contato para coordenação conforme necessário com a equipe da comunidade do TensorFlow.

Esta carta será postada inicialmente na lista de discussão do grupo. O repositório da comunidade na organização do TensorFlow GitHub arquivará esses documentos e políticas ( exemplo do Kubernetes ). À medida que qualquer grupo desenvolve suas práticas e convenções, esperamos que ele as documente na parte relevante do repositório da comunidade.

Colaboração e inclusão

Embora não seja obrigatório, o grupo deve optar por fazer uso da colaboração por meio de teleconferência agendada ou canais de bate-papo para conduzir as reuniões. Quaisquer dessas reuniões devem ser anunciadas na lista de mala direta, e notas postadas na lista de mala direta posteriormente. A reunião regular ajuda a impulsionar a responsabilidade e o progresso em um SIG.

Os membros da equipe da comunidade do TensorFlow monitorarão e incentivarão proativamente o grupo a discutir e agir conforme apropriado.

Lançamento

Atividades necessárias:

  • Notificar os grupos de discussão geral do TensorFlow ( discut@ , developers@ ).
  • Adicionando SIG às páginas da comunidade no site do TensorFlow.

Atividades opcionais:

  • Criação de uma postagem de blog para a comunidade de blog do TensorFlow.

Saúde e rescisão de SIGs

A equipe da comunidade TensorFlow fará o possível para garantir a integridade dos SIGs. Periodicamente, ele solicitará que o líder do SIG forneça um relatório do trabalho do SIG, que será usado para informar a comunidade mais ampla do TensorFlow sobre a atividade do grupo.

Se um SIG não tiver mais um propósito útil ou comunidade interessada, ele poderá ser arquivado e cessar a operação. A equipe da comunidade TF reserva-se o direito de arquivar tais SIGs inativos, a fim de manter a integridade do projeto como um todo, embora seja um resultado menos preferível. Um SIG também pode optar por se desfazer se reconhecer que chegou ao fim de sua vida útil.