<?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 Lucas Machado on Medium]]></title>
        <description><![CDATA[Stories by Lucas Machado on Medium]]></description>
        <link>https://medium.com/@lucasmachado_85525?source=rss-32a86ea6ea0b------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*Kmb3Fzq7kLfP8R7Q.</url>
            <title>Stories by Lucas Machado on Medium</title>
            <link>https://medium.com/@lucasmachado_85525?source=rss-32a86ea6ea0b------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 20:30:31 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@lucasmachado_85525/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[Repensando a revisão de código]]></title>
            <link>https://medium.com/contabilizei-tecnologia/repensando-a-revis%C3%A3o-de-c%C3%B3digo-e48553b53409?source=rss-32a86ea6ea0b------2</link>
            <guid isPermaLink="false">https://medium.com/p/e48553b53409</guid>
            <category><![CDATA[tecnologia]]></category>
            <category><![CDATA[process]]></category>
            <category><![CDATA[extreme-programming]]></category>
            <category><![CDATA[code-review]]></category>
            <category><![CDATA[methodology]]></category>
            <dc:creator><![CDATA[Lucas Machado]]></dc:creator>
            <pubDate>Tue, 11 Sep 2018 11:31:01 GMT</pubDate>
            <atom:updated>2018-09-11T14:19:05.591Z</atom:updated>
            <content:encoded><![CDATA[<h4>Como nos baseamos em uma forte cultura de equipe para fazer códigos melhores.</h4><p>Softwares complexos são desenvolvidos, comumente, por times. E pra que todas as vantagens do trabalho coletivo reflitam em resultado, não basta pensar de maneira quantitativa, isto é, no número de engenheiros desenvolvendo a solução. É preciso investir na qualidade da equipe que, por sua vez, também é muito mais que simplesmente agrupar profissionais talentosos.</p><p>O atraso dessa percepção pode criar ambientes desfavoráveis ao desenvolvimento de software de qualidade. Quando é esse o caso, as consequências são nefastas: deadlines perdidos, projetos de péssima manutenibilidade, elevados gastos de tempo e dinheiro em correções de falhas… caos. E uma vez que estamos no caos, nossa primeira reação, quase instintiva, é a de estancar a sangria. Na prática, isso geralmente significa criar processos e métricas de controle sem fim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*wVIc6u3GKI9V9eaDjuI_BA.gif" /><figcaption>Calma, é só o caos.</figcaption></figure><p>Você, leitor atencioso, pode estar se perguntando: onde a revisão de código (que está no título desse texto) se encaixa em toda essa história? Que <em>code review</em> é importante nós já sabemos, e os porquês ficam muito bem compreendidos nesse texto do <a href="https://medium.com/u/97616c226bd4">Mauricio Pelissari</a>:</p><p><a href="https://inside.contabilizei.com.br/revis%C3%A3o-de-c%C3%B3digo-d386519226a8">Revisão de Código</a></p><p>Mas a questão é que muitos podem enxergar a prática como sendo um dos tais processos de controle em ambientes caóticos. O meu objetivo com esse texto é dar uma outra visão pra essa prática tão falada no universo de desenvolvimento de software.</p><p>Para tal, gostaria de contar brevemente a nossa história (minha e da minha então equipe), que se deu em Novembro de 2017. Começamos a repensar nosso processo de revisão de código, muito por conta da nossa insatisfação com o processo que tínhamos: era burocrático e ineficiente. Diariamente, lidávamos com uma alta quantidade de bugs (técnicos e negociais) e tínhamos retrabalho constante. Mas pera lá… O processo garantia, em tese, que nenhum código entraria em produção sem aprovação de ao menos dois outros desenvolvedores. Por que tantas falhas passavam despercebidas à esse controle? Se eu fosse dar uma rápida resposta, seria a de que processos sem cultura de equipe = shit (do Inglês, merda).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/397/1*Vyt0bwlHLb8vQaJO6DzMJQ.jpeg" /></figure><p>A revisão do trabalho (de qualquer natureza) é uma prática <strong>comum</strong> em times altamente performáticos e integrados. <em>Code review</em> portanto, é uma consequência de uma boa <strong>cultura</strong> de engenharia de software. Essa cultura, ao meu ver, é a força capaz de construir equipes de qualidade (e é portanto a minha resposta à provocação feita na introdução do texto). Isso significaria dizer que processos são desnacessários? Absolutamente não, mas devemos ter a consciência de que processos são <strong>ferramentas</strong>. Não são a finalidade, são os meios.</p><p>Para a elaboração de um novo modelo, nos pautamos nesse <em>mindset</em> de cultura. Algumas coisas foram cruciais, como a <strong>autonomia </strong>que tivemos<strong> </strong>pra implementá-lo. Além disso, queríamos que ele fosse <strong>inclusivo e colaborativo. </strong>As definições<strong> </strong>de<strong> todos os pontos</strong> foram feitas com todos os desenvolvedores da equipe, que tiveram a mesma voz, e participaram ativamente da criação do processo. Isso fez muita diferença, porque no fim o desenvolvedor não estaria cumprindo uma burocracia imposta. Ele estaria cooperando para um ambiente que ele próprio ajudou a construir.</p><p>Outro erro que queríamos evitar é que, ao invés de criar algo generalista, que tivesse a ambição de funcionar pra todas as equipes da empresa, começamos a entender que o processo deveria satisfazer as necessidades <strong>da nosssa equipe. </strong>É natural de se esperar que as realidades e problemas de cada time sejam (bem) diferentes. E portanto demandam formas de lidar, de pensar e de se organizar igualmente diferentes. Nós entendemos que o processo (e qualquer outra ferramenta) deve se adaptar ao time, muito mais que o inverso.</p><p>Além disso não queríamos algo fixo, imutável. O processo que tínhamos já estava lá havia mais de um ano, do mesmo jeito. E certamente foi criado naquele contexto de estancar sangrias. Nessa altura do campeonato, a realidade já era outra. Sabemos que times estão em constante mudança, inclusive dos integrantes que o compõe (e, claro, queríamos que os novos integrantes se sentissem incluídos na cultura também). Assim pensamos em estabelecer um modelo que previsse sua própria evolução e refinamento, através de discussões periódicas entre os seus participantes. E pra que isso fosse possível em alto nível, estabelecemos <strong>métricas</strong> do processo pra nos embasarmos sempre em dados. Passamos a <strong>revisar o processo de revisão</strong>… Quanta sagacidade, não? :)</p><p>E por último, definimos as regras a serem seguidas, com as quais todos nós nos comprometemos. Por exemplo, a revisão de código é <strong>obrigatória </strong>pra qualquer demanda. Outra: temos que respeitar os processos de <em>code review</em> das outras equipes quando formos mexer em seus projetos. No fim, criamos um total de (apenas) cinco regras que devem ser respeitadas a qualquer custo.</p><p>Ao final de 3 reuniões acaloradas entre a equipe, várias mensagens trocadas em chat, muita discussão e principalmente muitos consentimentos, o resultado foi muito animador. O número de bugs reduziu cerca de 60% ao longo de 4 meses (é importante salientar que outras medidas que tomamos também cooperaram pra essa queda). A revisão de código começou a acontecer com <strong>mais frequência</strong> e de maneira muito <strong>mais</strong> <strong>orgânica</strong> na equipe. As formas de se fazer se diversificaram bastante, das quais destaco as seguintes mais utilizadas:</p><ul><li>Exposição de implementações e arquiteturas com toda a equipe em sala (geralmente usando uma televisão grande).</li><li>Pair reviews: revisões lado a lado que fazemos quando as demandas são maiores e/ou mais complexas, inclusive negocialmente.</li><li>Revisões remotas com as ferramentas do repositório online: revisões menores, que podem ser entendidas tranquilamente com, no máximo, simples descrições de commits. Ao mesmo tempo, tentamos<strong> evitar revisões remotas muito cansativas</strong> pro revisor (a chance de o revisor deixar passar uma falha é proporcional à quantidade de linhas alteradas do seu diff).</li></ul><p>De fato deixamos muita burocracia de lado, mas as revisões aumentaram em quantidade e qualidade. O controle deixou de existir? Muito pelo contrário, era feito e passou a atentar àquilo que realmente importa. Em nosso caso foi principalmente a quantidade de bugs por período, métrica que escolhemos juntos porque <strong>fazia sentido pro nosso contexto</strong>.</p><p>Ao fim dos primeiros ciclos, também notamos vários benefícios que não imaginávamos. Pra começar, o time estava bem mais integrado, não havendo projeto que algum membro não conhecesse. Quando começamos a trabalhar com Node.js, tecnologia que menos da metade da equipe conhecia, a curva de aprendizado média do time foi consideravelmente suavizada!</p><p>Esses foram meses bem animadores. Hoje, nosso principal desafio envolvendo <em>code review</em> é fazer a cultura forte que tivemos naquele momento ser perpetuada. O time posteriormente se dissipou em outros times menores, e nem todos eles tinham mais a mesma motivação. É de fato algo que traz muitos benefícios, mas necessita estar em <strong>discussão e aprimoramento constantes</strong>, pra que a ideia permaneça forte.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/461/1*KyTI71OSYRaRJeIJbs1IbQ.jpeg" /><figcaption>Ego. Ego em toda parte.</figcaption></figure><p>Por fim, pensar em processos que trabalham com a cultura é sempre desafiador. Muitos dos principais obstáculos geralmente envolvem os “sentimentos” dos envolvidos. Um desses obstáculos é o <strong>medo</strong> de mudança por algo que seja mais flexível, dinâmico e permissível. Sim, o medo de perder o controle. Tem o <strong>ego</strong>, não difícil de ser encontrado em altíssima quantidade entre os desenvolvedores. O excesso de ego pode impedir o compreendimento de que ningúem é tão foda a ponto de que seu trabalho não precise ser revisado. E finalmente a <strong>preguiça, </strong>seja de refatorar código revisado, ou de disponibilizar um tempo do seu dia pra revisar o trabalho alheio. A mágica começa a acontecer quando esses obstáculos são superados pela confiança e pelo espírito de trabalho em equipe.</p><p>P. S. Gostaria de agradecer muito à todos os envolvidos no processo. A equipe de desenvolvedores do time Soluções Internas eram, além de mim: Rômulo Farias, Renato Medeiros, Leandro Caffé e Guilherme Barczyszyn. Vocês são foda!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e48553b53409" width="1" height="1" alt=""><hr><p><a href="https://medium.com/contabilizei-tecnologia/repensando-a-revis%C3%A3o-de-c%C3%B3digo-e48553b53409">Repensando a revisão de código</a> was originally published in <a href="https://medium.com/contabilizei-tecnologia">Contabilizei</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>