<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Gabriel Ferreira on Medium]]></title>
        <description><![CDATA[Stories by Gabriel Ferreira on Medium]]></description>
        <link>https://medium.com/@gabrielbs?source=rss-46dfba6587b8------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*ImQ4635_jIXE-Y-ZZs7czw.jpeg</url>
            <title>Stories by Gabriel Ferreira on Medium</title>
            <link>https://medium.com/@gabrielbs?source=rss-46dfba6587b8------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 05:27:07 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@gabrielbs/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Dicas & Truques para criar Pull Requests limpos]]></title>
            <link>https://gabrielbs.medium.com/dicas-truques-para-criar-pull-requests-limpos-5c507e4fee48?source=rss-46dfba6587b8------2</link>
            <guid isPermaLink="false">https://medium.com/p/5c507e4fee48</guid>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[git]]></category>
            <category><![CDATA[pull-request]]></category>
            <category><![CDATA[code-review]]></category>
            <dc:creator><![CDATA[Gabriel Ferreira]]></dc:creator>
            <pubDate>Thu, 15 Apr 2021 00:23:19 GMT</pubDate>
            <atom:updated>2021-04-15T00:23:19.374Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*RQ1KtocwiXVM3-y4" /><figcaption>Photo by <a href="https://unsplash.com/@thecreative_exchange?utm_source=medium&amp;utm_medium=referral">The Creative Exchange</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>Entregar features rápido em produção, evitar que novos bugs sejam introduzidos em um codebase, compartilhar conhecimento entre o time. Esses, entre outros, são bons motivos para desenvolvedores se importarem em escrever um bom pull request.</p><p>A teoria é bem simples e já explicada em <a href="https://essenceofcode.com/2019/10/29/the-art-of-small-pull-requests/">muitos</a> <a href="https://blog.codeminer42.com/on-writing-a-great-pull-request-37c60ce6f31d/">posts</a> <a href="https://blog.carbonfive.com/why-write-good-pull-requests/#:~:text=Pull%20requests%20should%20be%20as,gives%20the%20reviewer%20immediate%20context.">por</a> <a href="https://github.blog/2015-01-21-how-to-write-the-perfect-pull-request/">aí</a> mas no dia-a-dia as coisas podem se complicar um pouco.</p><p>Não é incomum que desenvolvedores se empolguem e criem pull requests enormes que tratem de diversos assuntos, neste post eu vou listar alguns truques que podem ajudar a criar um pull request limpo mesmo se empolgando 😼</p><h3>Crie commits constantemente</h3><p>Um pull request grande é ruim, mas um pull request grande com commits enormes é ainda pior, para evitar que isso aconteça, faça commits constantemente.</p><p>O truque aqui é não pensar muito na mensagem de cada commit<strong> enquanto desenvolve</strong> já que próprio <em>Git</em> tem várias maneiras de <strong>editar as mensagens antes de enviar as modificações</strong> para o servidor, então uma prática que eu costumo fazer quando estou em uma linha de pensamento que eu não gostaria de parar por muito tempo para pensar na mensagem de commit mais adequada é ir commitando com mensagens que só me ajudem a lembrar <em>mais ou menos</em> do que aquele commit se trata e depois editar tudo com algum comando do Git como o git rebase -i ou o git reset --soft</p><h3>Sobre os comandos:</h3><p>git rebase -i</p><p>Este é um comando para reorganizar os seus commits antes de eles serem enviados para o servidor, ao utilizar o git rebase -i HEAD~3 por exemplo eu estou pedindo para que o git me ajude a editar de algumas formas os <strong>3 últimos commits</strong> que foram feitos e vai abrir algumas opções no editor de texto padrão, assim:</p><pre>pick 687a480 test message 1<br>pick eed1032 test message 2<br>pick ba9b92c test message 3</pre><pre># Rebase c4488aa..ba9b92c onto c4488aa (3 commands)<br>#<br># Commands:<br># p, pick &lt;commit&gt; = use commit<br># r, reword &lt;commit&gt; = use commit, but edit the commit message<br># e, edit &lt;commit&gt; = use commit, but stop for amending<br># s, squash &lt;commit&gt; = use commit, but meld into previous commit<br># f, fixup &lt;commit&gt; = like &quot;squash&quot;, but discard this commit&#39;s log message<br># x, exec &lt;command&gt; = run command (the rest of the line) using shell<br># b, break = stop here (continue rebase later with &#39;git rebase --continue&#39;)<br># d, drop &lt;commit&gt; = remove commit<br># l, label &lt;label&gt; = label current HEAD with a name<br># t, reset &lt;label&gt; = reset HEAD to a label<br># m, merge [-C &lt;commit&gt; | -c &lt;commit&gt;] &lt;label&gt; [# &lt;oneline&gt;]<br># .       create a merge commit using the original merge commit&#39;s<br># .       message (or the oneline, if no original merge commit was<br># .       specified). Use -c &lt;commit&gt; to reword the commit message.<br>#<br># These lines can be re-ordered; they are executed from top to bottom.<br>#<br># If you remove a line here THAT COMMIT WILL BE LOST.<br>#<br># However, if you remove everything, the rebase will be aborted.<br>#<br># Note that empty commits are commented out</pre><p>As 3 primeiras linhas são os commits e a primeira palavra é a ação que o rebase vai executar naquele commit, por padrão é o pick, se você reparar logo abaixo no arquivo, o comando lista quais as opções possíveis para serem executadas nos commits.</p><p>Os comandos que eu mais costumo usar para organizar um pull request são:</p><p>reword para editar a mensagem do commit</p><p>squash para unir algum commit com outro</p><p>edit para remover ou adicionar alguma alteração</p><p>drop para remover o commit em si</p><p>E obviamente pick para manter o commit como está 😛</p><p>git reset --soft</p><p>Esse basicamente joga fora os commits e deixa os arquivos como adicionados, quando é necessário reorganizar todos os arquivos que foram commitados é bem interessante usar este comando em conjunto com o git reset -- ou git restore --staged para voltar esses arquivos como &quot;não adicionados&quot;</p><h3>Crie pull requests pequenos e contextuais</h3><p>Um pull request que trata de vários assuntos é bem difícil de se revisar — e de se reverter caso necessário.</p><p>Se um pull request é <a href="https://smartbear.com/learn/code-review/best-practices-for-peer-code-review/">grande</a> <strong>ou</strong> possui commits que tratam de assuntos completamente diferentes, é algo para se repensar, mas e se isso for percebido quando o pull request já estiver aberto ou a branch já empurrada no servidor?</p><p>O truque aqui é dividir esse pull request em pull requests menores, para isso é possível usar o comando git rebase -i que foi explicado na dica de cima, mas de uma forma um pouco diferente.</p><p>Imaginando um cenário onde a branch já está empurrada no servidor, é possível <em>splitar</em> essa branch em branches menores, por exemplo:</p><p>A branch chamada “branch-muito-grande” foi empurrada para o servidor, para splitar ela em menores é possível criar uma branch a partir dela e escolher apenas os commits que fazem sentido para aquele contexto, assim:</p><p>git checkout branch-muito-grande Para ir para branch target</p><p>git checkout -b branch-com-commits-específicos Para criar uma nova branch para deixar apenas com os commits necessários</p><p>git rebase -i HEAD~5 Lista os 5 últimos commits da branch</p><pre>pick 687a480 test 1<br>pick eed1032 test 2<br>pick ba9b92c test 3<br>pick dadb84c test 4<br>pick ddba100 test 5<br>....<br>....</pre><p>Agora é só escolher quais commits devem ficar nessa branch, usando a ação drop</p><p>Para que apenas os commits 3 e 4 permaneçam nesta branch, a edição do arquivo deverá ficar desta forma:</p><pre>drop 687a480 test 1<br>drop eed1032 test 2<br>pick ba9b92c test 3<br>pick dadb84c test 4<br>drop ddba100 test 5<br>....<br>....</pre><p>Agora o pull request que vai ser aberto com essa branch vai ter apenas os commits 3 e 4.</p><p>Tá aí <em>novamente </em>a<em> </em>importância de fazer bons commits antes de empurrar a branch para o servidor, até esse trabalho de refatoração do pull request ficaria mais fácil com uma lista de commits eficiente 👊</p><p>… Maaas, se não for o caso, lembre-se que ainda é possível utilizar as outras opções do rebase -i e/ou do reset --soft aqui também 😉</p><h3>Quando saber o momento de abrir um Pull Request? — <a href="https://github.com/gabrielbs/vscode-pull-request-time">It’s Pull Request Time</a>?</h3><p>A resposta simples é: O quanto antes.</p><p>Quanto mais cedo um pull request for aberto, menos modificações ele vai ter e mais cedo o seu time/os contribuidores do repositório vão conseguir ajudar em alguma coisa.</p><p>A chave para criar um pull request limpo é organizar os commits de uma forma eficiente e como foi dito na primeira dica, <em>commitar regularmente.</em></p><p>Como essa não é uma tarefa tão fácil quando não se está acostumado, eu criei uma <a href="https://github.com/gabrielbs/vscode-pull-request-time">extensão para o Visual Studio Code</a> que te lembra de fazer um commit com as suas mudanças quando um certo número de modificações é registrado no Git.</p><p>Espero que esse conjunto truques &amp; ferramentas te ajude a criar pull requests ainda melhores 💜</p><p>Obrigado e até próxima :)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5c507e4fee48" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>