Como contribuo com código para o Joomla?


19

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!

Respostas:


10

É 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ê deseja editar mais arquivos, pode 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 :-)


4

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 descrição do recurso de uma ou duas palavras para o nome da ramificação. Se for uma correção de bug na JFormclasse, use bugfix-jform. Isso facilita muito a identificação no que você está trabalhando, verificando suas ramificações git git branch -a.

Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.