ti-enxame.com

Como contribuo com código para o Joomla?

Estou ciente de que o código é gerenciado em https://github.com/joomla/joomla-cms (pelo menos para o CMS) e que devo enviar solicitações pull para sugerir que o código seja adicionado.

Estou especialmente interessado em algumas boas dicas para gerenciar minhas contribuições e garantir que o código chegue ao lugar certo.

Devo usar ramificações diferentes no meu repositório bifurcado para gerenciar contribuições diferentes? Em caso afirmativo, qual é a melhor maneira de vincular esse ramo aos principais ramos do repositório Joomla?

Existe um bom método para manter minha cópia bifurcada atualizada?

Qualquer sugestão sobre um bom fluxo para gerenciar esse processo seria realmente útil!

19
David Fritsch

É sempre bom ter uma ramificação dedicada para cada solicitação de recebimento que você fará.

Uma das maneiras mais simples de criar uma nova ramificação atualizada é usar o gui da web do GitHub para editar o arquivo no repositório original. Ao salvar, o GitHub criará automaticamente uma nova ramificação no seu fork, com base na ramificação que você editar atualmente. Se você quiser editar mais arquivos, poderá editá-los em sua ramificação recém-criada e atualizada.

Se você está um pouco familiarizado com o Git, refaz seu ramo de armazenamento temporário bifurcado com o ramo original upstream para que fique sincronizado antes de criar novos ramos. Além disso, se você precisar atualizar um PR, é recomendável restaurá-lo em vez de mesclar o mestre. Enquanto os dois lados funcionam, os commits de mesclagem estão apenas criando um histórico ruim e são mais difíceis de esmagar.

De um modo geral, os PRs devem ser "atômicos". Isso significa que se você tentar consertar algo, conserte apenas esse bug específico. Não corrija dois bugs diferentes no mesmo PR e também não faça correções no estilo de código. É mais fácil testar e também menos provável criar conflitos se o PR durar um pouco mais do que o esperado.

E, é claro, adicione uma boa descrição do que você deseja fazer e instruções de teste para reproduzir o problema e testar sua correção :-)

10
Bakual

Uma coisa importante que ajuda a agrupar suas contribuições é mover cada contribuição para uma ramificação separada e adequadamente nomeada. Se você estiver adicionando um recurso, use um prefixo como feature- e adicione uma ou duas descrições de recursos do Word para o nome da filial. Se for uma correção de bug na classe JForm, use bugfix-jform. Isso torna realmente fácil identificar o que você está trabalhando, verificando suas ramificações do git via git branch -a.

4
Don Gilbert