O Que É Uma Revisão de Código?

Discover how to deliver better software and systems in rapidly scaling environments. Join our Community

Quer que as suas equipas sejam ágeis, auto-organizadas e eficientes — especialmente quando se trata de simplificar o desenvolvimento de software para funcionários remotos. Então, qual é a melhor forma de conseguir que todos trabalhem em conjunto e manter cada membro da equipa a par? A revisão de código. O que é uma revisão de […]

Quer que as suas equipas sejam ágeis, auto-organizadas e eficientes — especialmente quando se trata de simplificar o desenvolvimento de software para funcionários remotos. Então, qual é a melhor forma de conseguir que todos trabalhem em conjunto e manter cada membro da equipa a par? A revisão de código.

O que é uma revisão de código? Também conhecido como revisão de código por pares, este processo garante que todos aprendem a base de código, melhoram a legibilidade do código, reduzem o tempo de revisão, verificam se existem erros no código e ajudam a equipa a conhecer novas técnicas e tecnologias para desenvolver as suas competências.

Se está pronto para saber mais sobre o processo de revisão de código no desenvolvimento de software e sobre os benefícios que pode trazer à sua equipa, continue a ler para conhecer todos os detalhes.

O processo de revisão de código

  • Existem erros lógicos óbvios no código?
  • Todos os casos estão totalmente implementados conforme estabelecido pelos requisitos?
  • Os testes automatizados são suficientemente bons para testar o código? 
  • É necessário reescrever algum dos testes para testar melhor este código?
  • Todas as orientações de estilo estão a ser cumpridas com este novo código?

Integrar a revisão de código no seu fluxo de trabalho

Sabia que, sem a revisão de código como parte do seu processo, pode estar a gastar até 80% do seu tempo na fase inicial a tentar corrigir problemas causados por requisitos e métricas não documentados, anomalias nos dados, atividade inesperada dos utilizadores, incompatibilidades de hardware e problemas de instalação?

Se a revisão de código não fizer parte do seu processo atual, está na altura de a integrar imediatamente nas fases de testes — independentemente do seu estilo de fluxo de trabalho. Por exemplo, pode estar a utilizar fluxos de trabalho baseados em tarefas e ramificações. Se for esse o caso, inicie a revisão do código-fonte assim que todo o código estiver concluído e os testes automatizados tiverem sido executados com sucesso. Chegou então o momento de integrar o código na linha principal, permitindo que os revisores de código verifiquem se existem aspetos que os testes automatizados possam ter ignorado. Ao integrar a revisão de código desta forma, minimiza decisões de programação inadequadas e evita a poluição do desenvolvimento da linha principal. 

Então, como pode integrar a revisão de código no seu fluxo de trabalho? Tudo dependerá do seu processo. Consulte alguns dos fluxos de trabalho mais comuns e veja onde recomendamos adicionar a revisão de código.

  • Fluxo de trabalho em cascata: 

Este ciclo de vida do desenvolvimento de software é normalmente utilizado por grandes organizações ou agências que exigem documentação exaustiva sobre todos os requisitos e o âmbito antes do desenvolvimento do projeto. É uma abordagem rígida, com pouca capacidade para grandes alterações.

Planeamento > Requisitos > Conceção do sistema & do software > Implementação > Testes > Revisão de código > Implementação > Manutenção & atualizações

  • Modelo de desenvolvimento baseado em protótipos:

Se não tiver a certeza daquilo de que os utilizadores podem ou não gostar, este processo de desenvolvimento de software proporciona-lhe uma oportunidade para avaliar o risco antes de lançar qualquer produto no mercado. Os protótipos podem ser descartados ou melhorados após os testes.

Desde o desenvolvimento ágil de software até aos modelos de desenvolvimento iterativo e incremental, a revisão de código deve fazer parte da fase de testes em todos os fluxos de trabalho.

Get Free Access
Get regular tech leadership wisdom for delivering better software and systems.
Get Free Access

Have an account? Log In

Benefícios da revisão de código por pares

Embora todos os tipos de equipas possam beneficiar da revisão de código, esta é verdadeiramente transformadora para as equipas ágeis devido à descentralização inerente a este fluxo de trabalho. Com sistemas de revisão de código implementados, a sua equipa pode partilhar conhecimento em toda a equipa para fazer estimativas melhores, orientar novos engenheiros, permitir ausências e distribuir o trabalho.

Estimativas melhores

Uma vez que a estimativa é essencialmente um exercício de equipa, obtém melhores resultados quando o conhecimento do produto é partilhado por toda a equipa de desenvolvimento. Sempre que são integradas novas funcionalidades no código existente, o programador original é apenas uma pessoa capaz de fornecer comentários úteis. Qualquer pessoa que tenha participado numa revisão de código também terá conhecimento dos problemas conhecidos, da complexidade e das áreas preocupantes da base de código. Terá vários contributos informados que tornam a sua estimativa final mais fiável.

Os programadores experientes podem orientar os novos

Pode pensar que a revisão de código se destina apenas a programadores sénior que supervisionam programadores júnior. Mas isso não é verdade! Um dos aspetos de uma equipa ágil ou descentralizada de programadores é o facto de os membros experientes e novos da equipa trabalharem frequentemente em conjunto. Quando todos podem participar na revisão de código, poupa tempo e facilita as conversas sobre o código, além de dar aos novos membros a oportunidade de apresentar uma perspetiva diferente.

Ativar ausência

Quando só tem um programador que possui todo o conhecimento relacionado com o código, essa pessoa é o único ponto de contacto para o projeto em questão. Se essa pessoa estiver offline ou de férias, a quem irá o resto da sua equipa recorrer se surgir algum problema? Com a revisão de código, várias pessoas devem ter os conhecimentos necessários para assumir o controlo e orientar o projeto — independentemente de quem esteja ou não no escritório!

Abordagens comuns à revisão de código

Existem várias formas de abordar a revisão de código, incluindo através de cadeias de e-mails, programação em pares e revisão por cima do ombro. Consulte estas visões gerais para decidir qual é o processo mais adequado para a sua equipa.

Cadeia de e-mails

Quando o autor do código termina uma parte do código, pode enviar o ficheiro por e-mail a vários membros da equipa, para que o possam rever de forma independente assim que o respetivo fluxo de trabalho o permita. Flexível e adaptável, o método de revisão de código através de uma cadeia de e-mails pode ser um pouco mais simples do que reunir todos numa única reunião de revisão de código.

Programação em pares

Com esta abordagem ao desenvolvimento de software, os programadores trabalham lado a lado no mesmo código — revendo o código uns dos outros à medida que trabalham. Este processo integra efetivamente as alterações e as revisões de código diretamente no processo existente. No entanto, a programação em pares pode consumir mais tempo e ser mais exigente do que outros métodos.

Por cima do ombro

Por ser o processo mais antigo e simples, a revisão por cima do ombro é uma forma intuitiva de realizar revisões de código melhores. Quando terminar de escrever o código, basta pedir a um colega que se desloque ao seu posto de trabalho e reveja o código enquanto lhe explica o processo em tempo real. Este método é muito informal e, muitas vezes, não tem qualquer documentação associada à revisão.

More Articles

Ferramentas de revisão de código

Utilize ferramentas de revisão de código para obter revisões por pares ou utilizar automatizações digitais nas verificações de controlo de qualidade. Pode utilizar estas ferramentas em conjunto com métodos de revisão de código manuais e mais tradicionais.

Para experiências mais pequenas no desenvolvimento de interfaces, as plataformas de programação baseadas no navegador, como o CodePen, também podem facilitar o teste, a partilha e a obtenção de comentários sobre o seu código.

Simplifique o seu processo de revisão de código

Ninguém é infalível. E, uma vez que o código é escrito por pessoas, é inevitável que ocorram erros. Reduza os erros e garanta a qualidade com um processo de revisão de código que funcione para a sua equipa. Garantirá comentários mais atempados e elevará os padrões do seu código ao longo de todo o ciclo de vida do desenvolvimento.

Pronto para conhecer outros processos que irão melhorar a colaboração da sua equipa e a qualidade do seu produto? Torne-se assinante para receber aconselhamento e apoio regularmente!

Kyra Evans
Kyra Evans has over 15 years of experience writing about finance, technology, and corporate wellness for many of Canada’s largest brands. In addition to writing, Kyra provides keynotes and workshops in mindfulness and holistic wellbeing to companies ranging from startups to multinational corporations. She writes for an engaged community of more than 30,000 readers on Instagram and TikTok, and her work has been featured by publications such as HuffPost and Authority Magazine. She lives on Vancouver Island with her family.