Prática de pull request
TL;DR: agora você pode praticar a criação de pull requests no GitByBit!
Você já encontrou um bug no código de outra pessoa e pensou: "por que ainda não corrigiram isso?" Você abre uma issue, espera... e nada acontece.
Acontece o seguinte: você não precisa mais esperar.
Você pode arregaçar as mangas e enviar a correção por conta própria. É só abrir um pull request e conseguir o merge: de repente, todo mundo que usa aquela biblioteca se beneficia do seu trabalho.
Nunca dá para saber o que você vai puxar de um pull request.
Um bug de verdade, uma correção de verdade
A prática começa com um cenário bem plausível: seu app de atividades físicas buga quando alguém tenta registrar uma atividade em um campo de golfe usando distâncias em jardas. O app não sabe converter jardas em metros e trava. A correção é direta: adicionar a conversão que falta (1 jarda = 0,9144 metros). Você aplica o patch na biblioteca e segue com o seu dia.
Mas, depois de um tempo, chega uma atualização que quebra a sua correção. Você precisa reaplicar o patch. Aí acontece de novo. E de novo. Você percebe que está perdendo tempo com remendos inúteis, quando a correção deveria estar na própria biblioteca. Como fazer a correção chegar lá?
O poderoso pull request
A maioria dos projetos open source fica hospedada no GitHub ou em plataformas parecidas, e todas elas têm suporte a pull requests. Um pull request é uma forma de propor alterações em um projeto. Você forka o repositório, faz suas alterações e depois envia um pull request para o repositório original, sugerindo que suas alterações sejam mergeadas na base de código principal.
Além da parte técnica de forkar, criar branches e mergear, o processo de pull request também envolve comunicação. Você precisa explicar o que fez, por que é necessário e como isso melhora o projeto. É aqui que você pode mostrar que entende a base de código e que sabe contribuir direito. Não vai ajudar em nada se você estragar o pull request com mensagens de commit toscas, subir um monte de alterações sem relação entre si ou ignorar as diretrizes de contribuição do projeto.
Esse tipo de atitude nos comentários de um pull request não leva você a lugar nenhum.
Além disso, o vaivém de um pull request pode exigir que você atualize seu fork, faça rebase e resolva conflitos. Há todo um arsenal de habilidades de Git envolvido no processo, e agora você pode praticar todas elas no GitByBit, em um cenário realista com repositórios reais do GitHub.
Mandar bem em um pull request exige muita paciência e atenção aos detalhes.
Além da prática de pull request, adicionei várias entradas novas à Gitopedia, incluindo e . Também tem duas boas práticas novas: e .
