Diretório de Equipes do Fedora
In order to provide visibility into what teams exist and are active in Fedora, the Fedora Council decided to maintain a directory that receives regular checks. Fedora Council representatives are responsible for periodic evaluation of the teams under their area (DEI, Engineering, and Mindshare). "Teams" should be read as a catch-all term for groups in Fedora that may call themselves "Special Interest Groups (SIGs)", "Working Groups (WGs)", or any other similar term.
Intenção
O diretório da equipe tem como objetivo tornar visível:
-
Na comunidade, quais equipes estão ativas.
-
Como entrar em contato com elas.
O Fedora é uma comunidade extensa com diversas atividades, e o diretório ajudará membros da comunidade, tanto existentes quanto em potencial, a encontrar a equipe que procuram. Realizar verificações periódicas ajuda a garantir que as informações sejam precisas e que não direcionemos pessoas para equipes que não estejam 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 de DEI, Engenharia e Mindshare para o Fedora Council são responsáveis por garantir que a equipe sob sua área mantenha as informações atualizadas e remova equipes que pareçam não estar mais ativas. Eles não são responsáveis por fornecer as informações. Os representantes podem delegar seções de suas áreas conforme acharem adequado. As verificações podem ser feitas a qualquer momento, mas devem ser realizadas pelo menos em torno da data de ramificação de 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 Fedora Council
, The Fedora Council is our top-level community leadership and governance body. It is responsible for stewardship of the Fedora Project as a whole, and supports the health and growth of the Fedora community.
, etc. em qualquer lugar da página.
Want to help? Learn how to contribute to Fedora Docs ›