Como colaborar

Adoraríamos aceitar seus patches e contribuições para este projeto. Há apenas algumas pequenas orientações que você precisa seguir.

Contrato de Licença de Colaborador

As contribuições para qualquer projeto do Google precisam ser acompanhadas por um Contrato de Licença de Colaborador. Isso não é uma atribuição de direitos autorais, simplesmente concede ao Google permissão para usar e redistribuir suas contribuições como parte do projeto.

  • Se você é uma pessoa que escreve um código-fonte original e tem certeza de que tem a propriedade intelectual, assine um CLA individual.

  • Se você trabalha em uma empresa que gostaria de permitir a contribuição com seu trabalho, será necessário assinar um CLA corporativo.

Geralmente, você só precisa enviar um CLA uma vez. Portanto, se já enviou um (mesmo que tenha sido para um projeto diferente), provavelmente não vai precisar fazer isso de novo.

Como enviar um patch

  1. Geralmente, é melhor começar abrindo um novo problema descrevendo o bug ou o recurso que você quer corrigir. Mesmo que você ache relativamente simples, é útil saber no que as pessoas estão trabalhando. No problema inicial, mencione que você está planejando trabalhar nesse bug ou recurso para que ele possa ser atribuído a você.

  2. Siga o processo normal de bifurcação do projeto e configure uma nova ramificação para trabalhar. É importante que cada grupo de alterações seja feito em ramificações separadas para garantir que uma solicitação de envio inclua apenas as confirmações relacionadas a esse bug ou recurso.

  3. Qualquer mudança significativa quase sempre deve ser acompanhada por testes. O projeto já tem uma boa cobertura de teste. Portanto, confira alguns dos testes existentes se não tiver certeza de como fazer isso.

  4. Faça o seu melhor para ter mensagens de confirmação bem formadas para cada alteração. Isso proporciona consistência em todo o projeto e garante que as mensagens de confirmação possam ser formatadas corretamente por várias ferramentas git.

  5. Por fim, envie as confirmações para a bifurcação e envie uma solicitação de envio.