GNOME finalmente decide intensificar e renovar sua documentação para colaboradores

GNOME finalmente decide intensificar e renovar sua documentação para colaboradores

Se você quer contribuir com o GNOME, entender o que é preciso ficou mais fácil.

Muitos de nós estamos familiarizados com o GNOME, um dos melhores ambientes de desktop para Linux, preferido por muitos usuários por sua natureza fácil de usar e altamente personalizável.

Tudo isso é possível graças aos inúmeros colaboradores que trabalham no projeto GNOME para fornecer uma experiência muito perfeita em todo o GNOME e seus aplicativos.

Mas, havia um problema que vem assolando o projeto há algum tempo, que é a questão da documentação do projeto abaixo da média que foi considerada imprecisa ou redundante em muitas ocasiões.

Felizmente, Allan Day do Projeto GNOME anunciou algo muito legal que está pronto para mudar a forma como os colaboradores têm acesso a informações importantes referentes ao projeto.

Manual do Projeto GNOME: O que esperar?

gnome_handbook

Chamado de GNOME Project Handbook (handbook.gnome.org), ele destina-se a atuar como um recurso de documentação completo para colaboradores do GNOME, e não para fornecer documentação do usuário, páginas iniciais para aplicativos/bibliotecas ou documentação técnica.

Este site apresenta muito conteúdo da wiki existente, com a maioria deles sendo melhorados, e uma quantidade considerável de conteúdo original também. Além disso, como você pode ver acima, há muitas seções que atendem a diferentes casos de uso.

Há uma página chamada "Get in Touch" para obter informações sobre os canais de comunicação oficiais do projeto GNOME. Em seguida, uma página para "Governança" que explica como as decisões são tomadas no projeto, e uma página chamada "Infraestrutura" para detalhes sobre a infraestrutura do GNOME e muito mais.

O Manual do Projeto GNOME é mantido semelhante a como a maioria dos projetos do GNOME são tratados; usando um repositório GitLab para gerenciá-lo, com problemas a serem relatados e alterações a serem mescladas por meio de solicitações de mesclagem.

Além disso, este site se junta a uma linha existente de outros sites do GNOME que atendem às necessidades mencionadas anteriormente, são elas; apps.gnome.org, developer.gnome.org e welcome.gnome.org.

O objetivo final de todos esses sites é substituir o desatualizado GNOME Wiki, que está mostrando sua idade. Allan recomenda que os colaboradores passem a usar o manual e acabem com a wiki daqui para frente, pois planejam aposentar a wiki em um futuro próximo**.

Para ler mais, sugerimos que você passe pelo blog com o anúncio para saber mais sobre essa empreitada.

Você vai usar o Manual do Projeto GNOME? Ou prefere usar a wiki antiga?

Última atualização deste artigo: 31 de january de 2024