maven script interpreter

Contribuindo para o interpretador de scripts Apache Maven

Você encontrou um bug ou tem uma ideia para um novo recurso interessante? Contribuir com código é uma ótima maneira de retribuir à comunidade de código aberto. Antes de você se aprofundar no código, existem algumas diretrizes que precisamos que os colaboradores sigam para que possamos ter a chance de nos manter atualizados.

Começando

• Certifique-se de ter uma conta JIRA.

• Certifique-se de ter uma conta GitHub.

• Se você está planejando implementar um novo recurso, faz sentido discutir primeiro suas alterações na lista de desenvolvedores. Dessa forma, você pode ter certeza de que não está desperdiçando seu tempo com algo que não é considerado no escopo do Apache Maven.

• Envie um ticket para o seu problema, presumindo que ainda não exista.

• Descreva claramente o problema, incluindo etapas para reproduzi-lo quando for um bug.

• Certifique-se de preencher a versão mais antiga que você sabe que contém o problema.

• Bifurque o repositório no GitHub.

Fazendo e enviando alterações

Aceitamos solicitações pull via GitHub. A lista de discussão de desenvolvedores é o principal canal de comunicação dos colaboradores.
Existem algumas diretrizes que tornarão a aplicação de PRs mais fácil para nós:

• Crie um branch de tópico onde você deseja basear seu trabalho (geralmente é o branch master). Envie suas alterações para uma ramificação de tópico em sua bifurcação do repositório.

• Faça commits de unidades lógicas.

• Respeite o estilo de código original: ao usar o mesmo estilo de código, os patches devem apenas destacar a diferença real, não sendo perturbados por quaisquer problemas de formatação:

• Use apenas espaços para recuo.

• Crie diferenças mínimas - desative ações ao salvar, como reformatar o código-fonte ou organizar importações. Se você acha que o código-fonte deve ser reformatado, crie um PR separado para essa alteração.

• Verifique se há espaços em branco desnecessários com git diff --check antes de confirmar.

• Certifique-se de que suas mensagens de commit estejam no formato adequado. Sua mensagem de commit deve conter a chave do problema do JIRA.

[MSHARED-XXX] - Subject of the JIRA Ticket
 Optional supplemental description.

• Certifique-se de ter adicionado os testes necessários (JUnit/IT) para suas alterações.

• Execute todos os testes com mvn -Prun-its verify para garantir que nada mais foi quebrado acidentalmente.

• Envie uma solicitação pull para o repositório na organização Apache.

• Atualize seu tíquete JIRA e inclua um link para a solicitação pull no tíquete.

Se você planeja contribuir regularmente, considere preencher um contrato de licença de contribuidor.

Fazendo alterações triviais

Para alterações de natureza trivial em comentários e documentação, nem sempre é necessário criar um novo ticket no JIRA. Neste caso, é apropriado iniciar a primeira linha de um commit com '(doc)' em vez de um número de ticket.

Recursos Adicionais

• Contribuindo com patches

• Página do projeto de componentes compartilhados do Apache Maven

• Contrato de Licença de Colaborador

• Documentação geral do GitHub

• Documentação de solicitação pull do GitHub

• Conta do Twitter do Apache Maven

• Canal IRC #Maven em freenode.org