Dicas para novos mantenedores do GNU

Esta é uma tradução da página original em Inglês.

Se você é novo na manutenção de um pacote GNU, seja um que você tenha oferecido ao GNU ou um já existente que você adotou, pode ser trabalhoso demais saber por onde começar. O aviso oficial por e-mail que você recebeu quando se tornou mantenedor do GNU tem muitos detalhes; este documento não substitui esse e-mail, é apenas um complemento, com o objetivo de fornecer algumas dicas sobre como começar.

Obviamente, o que está listado aqui apenas mostra a superfície da manutenção do GNU. Leia o Guia de Manutenção do GNU e o Padrão de Codificação do GNU. De fato, você já deve ter lido, mas eles são suficientemente densos para que sejam releituras úteis e cuidadosas. Além disso, alguns colaboradores experientes do GNU se ofereceram para responder a perguntas sobre manutenção do GNU por meio de <[email protected]> e também <[email protected]>.

Primeiros passos para novos mantenedores

Essas tarefas são listadas em ordem de prioridade. Os rótulos ([Todos], [Novos] e [Adotados]) indicam a categoria de pacotes a que cada tarefa se aplica principalmente.

[Todos] Atualize as informações do projeto no Savannah. Acesse a página do seu projeto (https://sv.gnu.org/projects/PKG, onde PKG é o nome do seu pacote), autentique-se com seu ID do Savannah e verifique em “Editar informações públicas” no menu ”Principal”. Aqui você deve definir o nome completo do projeto e, se necessário, escrever uma descrição curta e uma descrição longa (envie também essas descrições para <[email protected]> para uso nas listas de todos os pacotes GNU). Você também deve definir seu status de desenvolvimento para refletir a maturidade do código. É essencial fazer isso se você adotou um pacote, pois ele estará marcado como “Órfão”.
[Todos] Vá às listas de discussão. Se você possui um novo pacote GNU, deve configurar pelo menos uma lista de discussão para o pacote (“Selecionar recursos” no menu “Principal”). É altamente recomendável ter uma com o nome <[email protected]>; outras podem esperar até o tráfego justificar. Se você adotou um pacote existente, envie um e-mail apresentando-se. Por fim, se as listas foram criadas recentemente ou já existem, não se esqueça de se inscrever, pois isso não é feito automaticamente. (Sobre lidar com correio.)
[Novos] Configure um repositório para seu código-fonte (“Selecionar recursos” no menu “Principal”) e importe o que estiver disponível (procure procedimentos sob “Gerenciador de código-fonte” na seção “Ferramentas de desenvolvimento”). A experiência mostrou que auto-hospedagem não é confiável. (Sobre arquivos backup.)
[Novos] Envie seu pacote para o site FTP do GNU se ele já estiver pronto para lançamento público. (Sobre o procedimento de envio.)
[Novos] Crie uma página inicial no GNU para substituir o arquivo PKG.html que os webmasters colocaram em seu repositório web (mantenha o mesmo nome). Se você deseja tornar isso rápido e fácil, use nosso modelo padrão. Comente as partes irrelevantes, tal como Download e Documentação se seu projeto mal começou; você vai completá-los posteriormente. Coloque também qualquer documentação que você já tenha em um subdiretório chamado “manual”. (Sobre páginas web.)
[Adotados] Verifique relatórios de erros existentes se você tiver adotado um pacote existente. Estes podem estar em qualquer ou em todos os rastreadores de erros do Savannah, numa lista de discussão (arquivos mbox podem ser baixados por HTTPS) ou no servidor GNU debbugs. (Sobre responder a relatórios de erros.)
[Adotados] Contate os empacotadores de distribuições. Se você adotou um pacote existente e ele está disponível nas distribuições downstream, entre em contato com os empacotadores. É provável que eles tenham relatórios de erros não resolvidos a serem tratados e talvez até patches que devem ser aplicados. Você também pode se envolver com o gerenciador de pacotes GNU Guix. (Sobre distribuições.)
[Adotados] Use o software. Não é necessário dizer que, se você adotou um pacote GNU, deve usá-lo para ter uma ideia do seu status atual e descobrir o que pode precisar ser corrigido.
[Todos] Pegue algumas tarefas e comece a hackear! Não há substituto para gastar tempo fazendo o trabalho real.

Dicas gerais sobre manutenção de software GNU

Busque fazer um primeiro lançamento rápido. Se o seu pacote é novo ou você adotou um anterior, sua prioridade número um deve ser um primeiro lançamento o mais rápido possível. Se você adotou um pacote, é suficiente corrigir alguns erros e enviá-lo. De fato, apenas atualizar os arquivos de infraestrutura (por exemplo, Autoconf/Automake, módulos gnulib etc.) é suficiente para justificar uma nova versão quando você assume o pacote pela primeira vez. Se o seu pacote for novo, não tenha medo de lançar uma versão inicial que ainda não esteja completa. De qualquer forma, uma versão (com anúncios adequados) chamará a atenção para o seu pacote na forma de usuários em potencial ou até outros desenvolvedores. É a melhor maneira de informar às pessoas que um pacote antigo foi revivido ou que existe um novo pacote. (Sobre como fazer lançamentos.)
Concentre-se em corrigir os erros pendentes primeiro. Esta é uma excelente maneira de começar a aprender uma nova base de código e ter uma ideia de como o sistema funciona. Além disso, novos recursos não devem receber muito foco se já existirem problemas notáveis. (Sobre recursos para desenvolvedores GNU.)
Não tente reescrever tudo. Se você adotou um pacote, é altamente recomendável que você não reescreva todo o programa do zero. Embora seja sempre tentador e fácil de começar, concluí-lo com sucesso exige um esforço colossal, e a experiência mostrou que é uma maneira quase certa de se desmotivar e levar à eventual (re)estagnação do projeto. Em vez disso, concentre-se em melhorias incrementais. Depois de se familiarizar intimamente com o pacote, você estará em uma posição melhor para considerar mudanças mais radicais.
Você está no comando! Como mantenedor, você cuida de um pacote como parte do projeto geral do GNU. O GNU depende de você para cuidar de assuntos legais, fazer novos lançamentos, manter as páginas web atualizadas, responder a relatórios de erros e comunicar-se com os usuários, manusear os patches adequadamente e tudo mais. Esse é seu privilégio e sua responsabilidade. Ajude-nos a manter uma coleção ativa e estável de software. Se você tiver dúvidas ou tiver problemas, não hesite em entrar em contato através do e-mail <[email protected]>. (Sobre o recrutamento de desenvolvedores.)
Envolva-se. O GNU consiste inteiramente de voluntários e sua participação na organização é o que você faz dela! Como mantenedor, a comunicação recebida de nós (leia-se: ser importunado) será de baixo volume. Ser ativo no GNU é uma ótima maneira de aumentar seu contato e exposição a outros voluntários com ideias semelhantes. Se você encontrar um aspecto do GNU no qual gostaria de se envolver, quase certamente há espaço para contribuição. (Sobre como ajudar o GNU e o Software Livre.)

Para concluir esta lista, uma reiteração final: as informações e links acima são apenas uma amostra. Consulte e (re)leia os documentos Informações do Mantenedor GNU e Padrão de Codificação GNU para muito mais.

Filosofia GNU

Isso também parece ser uma página apropriada para dar alguns links sobre as ideias básicas do GNU e do Software Livre: