Dicas para novos mantenedores do GNU
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, mas 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 <mentors@gnu.org> e também <maintainers@gnu.org>.
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
<maintainers@gnu.org> 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 <bug-PKG@gnu.org>; 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”). 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á tem em um subdiretório chamado “manual”. (Sobre páginas web.)
- [Adotados] Verifique relatórios de erros
existentes se você tiver adotado um pacote existente. Esses podem estar
em qualquer ou em todos os rastreadores de erros do Savannah, uma lista de discussão (arquivos mbox podem
ser baixados por HTTPS) ou
o 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 <maintainers@gnu.org>. (Sobre o
recrutamento de desenvolvedores.)
- Envolva-se. 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: importunando) 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 com 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 do GNU
Isso também parece ser uma página apropriada na qual dar alguns links para
as ideias básicas do GNU e do software livre: