Diretório de Equipes do Fedora

A fim de fornecer visibilidade sobre quais equipes existem e que estão ativas no Fedora, o Conselho decidiu para manter um diretório que recebe verificações regulares. Os representantes do conselho são responsáveis pela avaliação periódica das equipes de sua área (D&I, Engenharia e Mindshare). "Equipes" deve ser lido como um termo geral para grupos no Fedora que podem se autodenominar "Grupos de Interesse Especial (SIGs)", "Grupos de Trabalho" ou qualquer outro termo semelhante.

Intenção

O objetivo do diretório de equipes é tornar visível: 1. quais equipes estão ativas na comunidade e 2. como contatá-las. O Fedora é uma grande comunidade com muitas atividades diferentes, e o diretório ajudará os membros existentes e potenciais da comunidade a encontrar a equipe que procuram. Ter verificações periódicas ajuda a garantir que as informações sejam precisas e que não apontemos as pessoas para equipes que não estão mais ativas.

A intenção não é aumentar a carga administrativa sobre as equipes ou as barreiras para começar uma equipe. A intenção é não dizer "se você não está listado, você não tem permissão para fazer parte do Fedora". No entanto, a presença no diretório pode ser usada por outras equipes para avaliar solicitações de financiamento ou trabalho (por exemplo, trabalho do site ou recursos de design).

Conteúdo

As equipes devem listar as seguintes informações no formato especificado pelo modelo:

  • Nome da equipe

  • Resumo da equipe

  • Site da equipe

  • Status da equipe (ativa ou inativa)

  • Canal de comunicação assíncrono preferido da equipe (por exemplo, lista de discussão, categoria do fórum, etc.)

  • Canal de comunicação síncrona preferido da equipe (por exemplo, canal IRC, sala de telegrama, etc)

  • Rastreador de problemas da equipe

  • Reunião da equipe (de preferência um link para um evento Fedocal, alternativamente um dia e hora estáticos)

  • Informações adicionais que a equipe deseja publicar no diretório

Espera-se que nem todas as equipes tenham respostas para o acima. Eles devem ser fornecidos quando existirem.

O conteúdo pode ser armazenado no repositório council-docs se a equipe não tiver seu próprio repositório de documentos. Se uma equipe tiver seu próprio repositório de documentos, o conteúdo pode ser mantido nesse repositório para que possa ser usado para renderizar a própria documentação da equipe. Isso permite uma única fonte de verdade e evita que o conteúdo divirja.

Responsabilidades

As equipes são responsáveis por garantir que suas informações estejam atualizadas.

Os representantes da Diversidade & Inclusão, Engenharia e Mindshare no Conselho do Fedora são responsáveis por garantir que a equipe que está sob sua área mantenha as informações atualizadas e remover as equipes que não parecem estar ativas. Eles não são responsáveis por fornecer as informações. Os representantes podem delegar seções de sua área conforme acharem adequado. As verificações podem ser feitas a qualquer momento, mas devem ser feitas no mínimo próximo à data do branch para cada lançamento.

Mecanismo

Arquivos de informações da equipe

O diretório requer um arquivo que contém as informações sobre a equipe. A convenção de nomenclatura sugerida é NOME_team_info.adoc, mas qualquer nome de arquivo válido é aceitável. O arquivo pode ser armazenado no repositório de documentação da própria equipe ou no repositório council-docs. Consulte exemplo de modelo para formato e estrutura.

Renderizando o diretório

As equipes aparecerão no diretório se o arquivo de informações da equipe estiver incluído no diretório {engineering,mindshare}/modules/ROOT/pages/index.adoc do https://pagure.io/Fedora-Council/council-docs /[repositório council-docs]. Após incluir, com include, o arquivo de informações, a página de índice deve incluir o arquivo team_render.adoc que define a renderização.

Reusando os dados em páginas de equipe

As equipes podem incluir seu arquivo NOME_team_info.adoc em sua(s) página(s), e então usar {team_name}, {team_summary}, etc. em qualquer lugar da página.