Diretório de Equipes do Fedora
Para oferecer visibilidade sobre quais equipes existem e estão ativas no Fedora, o decidiu manter um diretório que recebe verificações regulares. Representantes do Fedora Council são responsáveis pela avaliação periódica das equipes em suas respectivas áreas (DEI, Engenharia e Mindshare). "Equipes" devem ser entendidas como um termo abrangente para grupos no Fedora que podem se autodenominar "Grupos de Interesse Especial (SIGs)", "Grupos de Trabalho (WGs)" ou qualquer outro termo semelhante.
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.
Responsibilities
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 ›