DEV Community: Engenheira Coelho 🐇

6 Good practices for code review

Engenheira Coelho 🐇 — Mon, 15 Jul 2024 14:48:44 +0000

The code review process is often carried out in software projects that have a minimum quality structure. This process consists of, after a developer finishes a task and generates a pull request (PR), another developer will analyze and indicate improvements to this code.

Thus, developers work on improving the code over time, increasing the level of code quality and avoiding possible bugs. Furthermore, contributing to the improvement of technical skills and leveling time.

6 Best Practices to run on Code Review

Use positive emoticons only, i.e. 👍🏽, ✅, 🚀, 😊.
Don't refactor someone else's PR without them knowing. Refactoring without informing takes away the developer's learning opportunity.
Prefer to explain your suggestions with small pieces of code or links that direct the developer.
Whenever possible, respond to comments in PR. Enabling the setting to send new comment alerts to your email can be a great practice.
Prefer to use suggestive rather than imperative language. Another good option is to use questions; Example:

Example 1

❌ “It got bad”
✔️” It’s a great practice to use more descriptive names.
Suggestion: isFlowStateFinished”.

Example 2
❌ “None of this was good”
✔️ “It’s more interesting to use the MVC pattern. Can you
notice the associated improvements? We can talk better
about 😄”.

*Example 3 *
❌ “This one is performing poorly”
✔️ “Using find() could generate better performance in this piece
of code”.

In larger or more advanced PRs, congratulate, or send a positive message, on approval of the PR. Working with development is usually not easy, encouragement from colleagues is a very positive practice. Although it may seem simple, this practice helps maintain culture and good climate.

Did you like the tips? Comment here if you use other interesting practices in code review 😄

✨ 40 FERRAMENTAS para aprender a programar usando o celular

Engenheira Coelho 🐇 — Tue, 03 May 2022 16:30:34 +0000

Essas ferramentas podem ajudar quando não houver um computador para estudar. Assim, você consegue se manter ativo(a) nos estudos.

Grasshopper
Acesse: https://grasshopper.app/pt_br/
Mimo

Acesse: https://getmimo.com/

Sololearn

Acesse: https://www.sololearn.com/home

Enki

Acesse:

Android: https://play.google.com/store/apps/details?id=com.enki.insights&hl=pt_BR&gl=US

iOS: https://apps.apple.com/us/app/enki-coding-learn-to-code/id993753145

Memo

Acesse: https://memobeta.webflow.io/

Codemurai

Acesse:

Android:https://play.google.com/store/apps/details?id=com.zenva.codemurai&hl=pt_BR&gl=US

iOS: https://apps.apple.com/br/app/codemurai/id1136578460

Pseudocode

Acesse: https://play.google.com/store/apps/details?id=pe.diegoveloper.pseudocode&hl=pt_BR&gl=US

Encode

Acesse:

Android: https://play.google.com/store/apps/details?id=com.upskew.encode&hl=pt_BR&gl=US

iOS:https://apps.apple.com/us/app/encode-learn-to-code/id1198851756

Duo Programador

Acesse: https://play.google.com/store/apps/details?id=com.souza.duolingo_flutter&hl=pt_BR&gl=US

Robsi

Acesse: https://play.google.com/store/apps/details?id=co.robsi.app&hl=pt_BR&gl=US

Master Coding

Acesse: https://play.google.com/store/apps/details?id=net.androidsquad.androidmaster&hl=pt_BR&gl=US

Codee

Acesse: https://play.google.com/store/apps/details?id=com.coding.adventure.android&hl=pt_BR&gl=US

Zenva

Acesse:

Android:https://play.google.com/store/apps/details?id=com.zenva.zvamobile&hl=pt_BR&gl=US

iOS: https://apps.apple.com/us/app/zenva-learn-programming/id1462379355

Codify

Acesse: https://play.google.com/store/apps/details?id=com.programming.codify

Coding Dojo

Acesse: https://play.google.com/store/apps/details?id=com.traveltest.coding_dojo_app

Herói da Programação

Acesse: https://play.google.com/store/apps/details?id=com.learnprogramming.codecamp&hl=pt_BR&gl=US

mBlock

Acesse: https://mblock.makeblock.com/en-us/

Learn99

Acesse: https://play.google.com/store/apps/details?id=com.mayurchaure.learn99

CodeGalaxy

Acesse: https://codegalaxy.io/android

Coderslang

Acesse: https://play.google.com/store/apps/details?id=com.coderslang.com&hl=pt_BR&gl=US

W3school

Acesse: https://play.google.com/store/apps/details?id=com.codes.school

Meoweb

Acesse: https://play.google.com/store/apps/details?id=br.com.tapps.meoweb&hl=pt_BR&gl=US

Dio.me

Acesse: https://www.dio.me/

Codinguru

Acesse:

https://play.google.com/store/apps/details?id=com.skycodetech.codingquiz

Khan Academy

Acesse:

Android: https://play.google.com/store/apps/details?id=org.khanacademy.android&hl=pt_BR&gl=US

iOS: https://apps.apple.com/br/app/khan-academy/id469863705

CodeLand

Acesse: https://learnyland.com/code-land/

Coding Champ

Acesse: https://coding-champ.com/

freeCodeCamp

Acesse: https://play.google.com/store/apps/details?id=org.freecodecamp&hl=en&gl=US

SuaCode.ai

Acesse: https://suacode.ai/

Progman

Acesse: https://play.google.com/store/apps/details?id=com.aknayak.progman&hl=pt_BR&gl=US

While True:learn()

Acesse: https://luden.io/wtl/

SpriteBox

Acesse: https://spritebox.com/

DataCamp

Acesse: https://www.datacamp.com/mobile

CodeHub

Acesse: https://play.google.com/store/apps/details?id=com.CodeHub.competitivecoding&hl=pt_BR&gl=US

CodeGym

Acesse: https://play.google.com/store/apps/details?id=com.hitechrush.codegym&hl=pt_BR&gl=US

Easy Coder

Acesse:https://www.easycoder.io/

Emerald Codes

Acesse: https://play.google.com/store/apps/details?id=com.emeraldcodes.apk&hl=pt_BR&gl=US

Dcoder

Acesse: https://dcoder.tech/

WildLearner

Acesse: https://wildlearner.com/

Codecademy Go

Acesse:

Android: https://play.google.com/store/apps/details?id=com.ryzac.codecademygo

iOS: https://apps.apple.com/br/app/codecademy-go/id1376029326

Gostou das ferramentas? Conhece alguma que não foi colocada aqui?

Deixe nos comentários!

✨ 21 FERRAMENTAS que ajudam a fazer documentação de software

Engenheira Coelho 🐇 — Wed, 27 Apr 2022 18:16:32 +0000

A documentação técnica é uma das etapas que eu identifico como importantes para o desenvolvimento de software, principalmente quando trabalho com novos projetos. É o fio que une a equipe de desenvolvimento ao cliente, fazendo com que as visões e necessidades de projeto estejam alinhadas.

Essencialmente, essa é uma atividade executada por profissionais especializados em produto, no entanto, a documentação inicial também pode ser desenvolvida por pessoas desenvolvedoras de software, pois está diretamente relacionada ao dia-a-dia do processo de desenvolvimento, e existem ferramentas que podem ser utilizadas dentro do código, gerando uma documentação viva.

O manifesto ágil, orienta que as documentações que forem criadas devem ser somente as mais essenciais e necessárias para o desenvolvimento do produto (Cockburn, 2007). Eu concordo fortemente com esse posicionamento, e acredito que o desenvolvimento de documentação não pode ser negligenciado, pois pode gerar inúmeros benefícios, como os definidos por Highsmith:

Facilitar a comunicação e colaboração;
Melhorar a transferência de conhecimento;
Preservar informações históricas;
Ajudar a melhorias em progresso;
Satisfazer a necessidades legais e regulatórias;
Além disso, também seriam bons pontos:

Facilidade em negociações com o cliente;
Facilita o onboarding de novos colaboradores;
Facilita a manutenção das regras de negócio criticas
Muito se discute entre quais são as questões mais essenciais de documentação, entre elas as que considero importantes são as regras de negócio, diagramas gerais e documentação de API. Por isso, hoje trago 21 plataformas que podem ajudar na documentação:

PlantUML - Utilize linguagem escrita para gerar diagramas, e mantenha no código.
plantuml.com/starting
C4PlantUML - Implementa a documentação com diagramas utilizando anotações.
https://github.com/plantuml-stdlib/C4-PlantUML#getting-started
Postman - Use para testar e Gerar uma documentação da sua API.
www.getpostman.com
APIblueprint - Crie documentações de forma fácil.
apiblueprint.org/
FlowChat: Crie gráficos e diagramas
app.diagrams.net/
EdrawMax: Crie diagramas online
www.edrawmax.com/
Gliffy: Diagramas online com o time.
www.gliffy.com/
yUML: Desenhe diagramas UML
yuml.me/
Cucumber: Crie documentações que atualizam no Jira
cucumber.io/living-documentation/
Crie documentação viva no CI/CD
https://medium.com/docler-engineering/live-documentation-in-ci-cd-992363409b18
Lucidchart: Crie diagramas e mapas mentais online
www.lucidchart.com/pages/
Smartdraw: Crie gráficos
www.smartdraw.com
Drawio: Crie diagramas de casos de uso
drawio-app.com
online.visual-paradigm: Crie diagramas de casos de uso
https://online.visual-paradigm.com/pt/diagrams/features/use-case-diagram-software/
Creately: Crie diagramas colaborativos
creately.com/diagram-type/use-case/
Miro: Crie diagramas e fluxos de forma colaborativa e online
miro.com/pt/
Confluence: Documente utilizando Markdown
https://www.atlassian.com/br/software/confluence
Docsify: gerador de documentação com base em anotações no código para javascript.
https://docsify.js.org/#/
Utilize o Github para documentar:
https://docs.github.com/pt/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
JSdoc: Utilize anotações para documentar código javascript.
jsdoc.app
swagger: Utilize anotações para documentar código Java.
https://swagger.io/

O que achou da lista? Adicionaria mais algum site?

Deixe um comentário! Isso me ajuda bastante a continuar produzindo conteúdo.

14 dicas para ir bem em testes técnicos de projeto

Engenheira Coelho 🐇 — Fri, 22 Apr 2022 13:55:41 +0000

Testes técnicos são sempre uma etapa importante para o processo seletivo e para conseguir sua vaga. Nesse artigo vamos abordar dois testes comuns, que são o de implementação de projeto e o de análise de projeto. Confira abaixo.

Teste técnico de implementação de projeto

Nesse teste pode ser solicitado que você desenvolva um projeto específico, ou qualquer projeto também. Podem haver definições bem diretas e específicas, ou também nenhuma definição.

Preferencialmente, implemente com a stack da empresa.
Defina o projeto que deverá implementar. Caso ainda não esteja definido, você pode se inspirar em um desses: https://twitter.com/EngineerRabbit/status/1510979766668701702
Utilize design patterns.
Implemente testes unitários.
Atenção para as regras de negócio. Se alguma regra de negócio não ficar clara, pergunte até ficar.
Faça um read.me e entregue o projeto no GitHub, não em um arquivo zip.
Utilize pequenos commits e com um padrão.

Testes técnicos de Análise de projeto

Esse teste pode estar relacionado ao código fonte da empresa, a um pequeno projeto, ou pedaços de código. Pode ser um teste enviado, onde o dev deverá responder, ou um teste hands-on (feito em entrevista técnica).

Indique melhorias de arquitetura e design de código. Que você pode estudar no https://refactoring.guru/pt-br.
Organize o código, deixando declarações de variável e funções juntas. Assim, você conseguirá realizar a análise do código de forma mais simplificada.
Revise o código e aplique as técnicas mais comuns de entendimento de clean code.
Caso tenha código escrito em diferentes línguas (inglês/português) ou que usem diferentes termos para o mesmo conceito, indique que é uma boa prática estruturar.
Caso seja uma analise que será realizada e depois entregue, escreva um documento estruturado com as indicações de melhoria.
Analise todos os cenários de teste disponíveis, e sugira caso ainda esteja faltando algum.
Verifique melhorias de performance algorítmica.

Gostou das dicas? Deixe seu comentário!

💡 12 DICAS que vão te ajudar nos testes técnicos práticos acompanhados (Hands-On)

Engenheira Coelho 🐇 — Wed, 20 Apr 2022 13:25:10 +0000

Esse teste prático consiste em realizar a implementação de algum trecho de código ou projeto em tempo real com o acompanhamento de outras pessoas desenvolvedoras. Similar ao teste de quadro-branco porém, considera que as pessoas devem implementar utilizando o computador.

Treine com ferramentas HackerRansk, Codility, Codewars.
Estude algoritmos de base.
Quando a aplicação estiver pronta aplique clean code.
Escreva o código em inglês.
Mantenha a calma.
Se já tem um trecho de código, tente seguir padrões.
Pergunte e converse com as pessoas que estão acompanhando o teste.
Nem sempre as regras são simples. Se necessário, utilize os comentários para escrever as regras antes de implementar.
Pense em melhoria incremental, ou seja, implemente as melhorias aos poucos. Primeiro faça funcionar, depois melhores performance e escrita.
Não fale sobre termos que você ainda não pratica como se você já tivesse prática.
Seja honesto(a), não tem problema falar quando você não sabe sobre um tema.
No final, cite quais seriam possíveis melhoria para o código e implementação.

E aí, o que achou das dicas? Adicionaria mais alguma coisa?

Deixe seu comentário abaixo!

⭐ 20 PERGUNTAS QUE VOCÊ PRECISA saber responder nas entrevistas técnicas

Engenheira Coelho 🐇 — Tue, 19 Apr 2022 13:21:12 +0000

Algumas perguntas são muito comuns nas entrevistas técnicas, e pensar sobre elas previamente provavelmente facilitar o processo e te deixará mais tranquilo(a) para as outras perguntas que não estavam previstas.

1.Você pode me contar sua trajetória profissional?
Essa é a pergunta que provavelmente estará em todas as entrevistas. Aqui vale pensar sobre as experiências que trariam mais valor para a empresa que você quer entrar.

O que te interessou nessa vaga?
Talvez não te perguntem diretamente isso, mas ter isso em mente ajuda na entrevista.
Qual o projeto que você mais gostou de trabalhar?
Qual o maior projeto que você já atuou? Como era a estrutura do time?
Você poderia citar algum projeto ou situação que deu errado, e como você lidou com essa situação?
Você já cometeu alguma falha técnica? Tem alguma que lembre mais?
Aqui é válido demonstrar que errou, e o que aprendeu com isso. É muito difícil que as pessoas não tenham errado técnicamente, o que importa é como lidaram com isso.
Qual você acha que é uma característica que o time não pode deixar de ter?
O que você costuma fazer para se manter atualizado(a)?
Você já usou algum padrão de projeto? Poderia citar padrões arquiteturais que já utilizou, ou design patterns?
Você costuma utilizar algum padrão para os commits?
Você disse que utiliza o paradigma de programação , poderia me explicar quais são os principais conceitos utilizando exemplos do mundo real?
Como era a estrutura do time que você estava atuando na empresa anterior? Você trabalhou em conjunto com design/QA/PM?
Como você se sente realizando pair programming ou repassando informações para outras pessoas?
Você utiliza práticas de teste? Qual framework você já utilizou?
Como você lida com mudanças e feedbacks?
Isso pode não ser perguntado, mas provavelmente será analisado durante o teste de hands-on.
Quais conhecimentos você tem que vão fazer mais diferença para o projeto?
Quais conhecimentos você espera evoluir enquanto estiver trabalhando conosco?
Quais são os projetos que te deixam mais motivado(a)?
Você tem alguma pergunta? Tem sim, tem 20 perguntas pra você utilizar como base aqui: https://dev.to/engenheiracoelho/20-perguntas-para-fazer-nas-entrevistas-tecnicas-j8b
E aí, o que achou das perguntas? Adicionaria alguma coisa? Conta pra mim!

Deixe seu comentário!

⭐ 20 PERGUNTAS PARA FAZER nas entrevistas técnicas

Engenheira Coelho 🐇 — Mon, 18 Apr 2022 15:47:32 +0000

As entrevistas técnicas servem não só para avaliar seu conhecimento técnico e a empresa entender se você está apto(a) para a vaga, mas também para você ter um espaço para realizar perguntas.

Qual é o objetivo e responsabilidades da vaga que estou concorrendo?
Quais são os padrões do projeto? Existe estrutura padrão de branchs? Padrão de commits?
Qual é o tamanho do time?
Como é a estrutura do time? Possui QA? Possui PM? Design?
Existe exigência de horários específicos para trabalhar?
Quais são as reuniões e ritos mais comuns no time?
Como é o onboarding e período inicial de novas pessoas desenvolvedoras no projeto?
Qual é a principal necessidade, manutenção em um projeto legado ou construção de uma nova aplicação?
É necessário fazer hora extra?
Terei apoio e auxilio do time? Terá uma pessoa com a qual eu posso tirar dúvidas?
Como a empresa vê a prática de pair programming?
O projeto tem cobertura de testes? Como o time vê essa prática?
A empresa oferece treinamentos? Como a empresa vê a necessidade de novos conhecimentos?
Como é a rotina de trabalho?
A empresa tem algum plano ou projeto que auxilie no crescimento dos profissionais?
Como funcionam os feedbacks no time?
Perguntar quais são os frameworks e bibliotecas utilizadas.
Com relação a cultura do time, quais são as principais características esperadas de novos membros ao iniciarem no time.
Como funcionam as mudanças nos times?
Como são os prazos e reajustes de prazos?

E aí, o que achou das dicas? Conta pra mim!
Deixe seu comentário!

8 Dicas para facilitar o onboarding Dev em projetos

Engenheira Coelho 🐇 — Sat, 23 Oct 2021 18:31:18 +0000

Onboarding em inglês é embarcar, então essas dicas são especialmente para os desenvolvedores que estão embarcando em um novo projeto de software. O objetivo é facilitar a etapa inicial nos projetos, quando você ainda não conhece nada sobre o projeto.

Essas dicas podem te ajudar a fazer essa transição ser mais rápida e menos sofrida:

1 Entenda de forma ampla o negócio associado ao projeto. Depois, entenda questões mais estratégicas. No onboarding é suficiente entender o macro, pois em alguns projetos pode levar muito tempo entender todas as regras de negócio implementadas.

2 Identifique todas as ferramentas que são utilizadas pelo time, e solicite acesso. Entenda quais fazem mais diferença para o seu trabalho.

3 Entenda a responsabilidade de cada pessoa do time, isso faz diferença para resolver os problemas com a pessoa certa.

4 Entenda quem pode ser a pessoa que te ajudaria com dúvidas cotidianas, por exemplo, quem te falaria qual é o canal certo para pedir um mouse novo.

5 Marque um meeting com o propósito de entender a arquitetura do projeto. Nesse meeting pergunte todas as dúvidas, até as mais simples podem mostrar que uma decisão fora do óbvio foi tomada, e influenciar na implementação das tarefas do projeto.

6 Solicite que as pessoas te informem os canais mais importantes, ou que te enviem o documento principal da empresa, onde estão as definições de projeto.

7 Combine e identifique:

Padrão para criação de branch. Ou seja, como devem ser os nomes de branch.
Padrão de comentário de commit.
Padrão de criação de PR.
Utilização de lint, e padrões de escrita.
Branch base para desenvolvimento (preferencialmente develop).

8 Tenha paciência. Entender todo o projeto pode levar muito tempo, e dependendo da complexidade, talvez você nunca entenda todas as regras de negócio. 🤗

O processo de onboarding é super importante para a produtividade e adaptação de novos devs no time. Espero que essas dicas contribuam pra o teu processo :)

Curtiu? Tem mais dicas? Comenta aqui :)

6 Boas práticas para utilizar no code review

Engenheira Coelho 🐇 — Sat, 23 Oct 2021 18:23:48 +0000

O processo de code review é muito realizado em projetos de software que possuem uma estrutura mínima de qualidade. Esse procedimento consiste em, após uma pessoa desenvolvedora terminar uma tarefa e gerar um pull request (PR), outra pessoa desenvolvedora analisará e indicará melhorias para esse código.

Assim, as pessoas desenvolvedoras atuam na melhoria do código do time, aumentando o nível de qualidade do código e evitando possíveis bugs. Além disso, contribuindo para o aperfeiçoamento das habilidades técnicas e nivelando o time.

6 Boas práticas para executar no code review

Use emoticons apenas para demonstrar aprovação, por exemplo 👍🏽 , ✅, 🚀, 😊.
Não refatore o PR de outra pessoa sem que ela saiba. Caso sejam necessárias muitas modificações, realize comentários. Refatorar sem informar, retira a oportunidade de aprendizado da pessoa desenvolvedora.
Prefira explicar suas sugestões com pequenos pedaços de código ou links que direcionem a pessoa desenvolvedora.
Sempre que possível responda os comentários no PR. Habilitar a configuração para enviar alerta de novos comentários para o seu e-mail, pode ser uma ótima prática.
Prefira usar linguagem sugestiva à imperativa. Outra boa opção, é utilizar perguntas, por exemplo:

Exemplo 1

❌ ” Ficou ruim ”

✔️ ” É uma ótima prática utilizar nomes mais descritivos. Sugestão: isFlowStateFinished”.

Exemplo 2

❌ ” Nada disso ficou bom”

✔️ ” É mais interessante utilizarmos o padrão do MVC. Você consegue perceber as melhorias associadas? Podemos conversar melhor sobre 😄 ”.

Exemplo 3

❌ ” Esse for está com uma performance ruim”

✔️ ” Utilizar um find() poderia gerar uma performance melhor nesse trecho de código”.

Em PRs maiores ou mais difíceis dê parabéns, ou envie uma mensagem positiva, na aprovação do PR. Trabalhar com desenvolvimento normalmente não é fácil, o incentivo dos colegas é uma prática bem positiva. Apesar de parecer simples, essa prática ajuda na manutenção da cultura e clima.

Curtiu as dicas?

Comenta aqui se você utiliza outras práticas interessantes no code review 😄

Como debater ideias de forma produtiva. No trabalho ou na vida.

Engenheira Coelho 🐇 — Sat, 23 Oct 2021 18:18:52 +0000

Eu gosto muito de ideia debater e argumentar sobre diferentes idéias e modos de pensar, sempre tive a percepção de que em conversas o mais importante não é quem ganha ou quem perde, mas sim, que no final todos tenham entendido todas as visões de quem faz parte da conversa, e cheguem em uma solução sólida e factível.

Quase todos os debates se enquadram em uma de três categorias: o tipo em que o objetivo é persuadir as pessoas de que você está certo; o tipo em que o objetivo é parecer melhor do que seu oponente; e aquele em que o objetivo é encontrar as melhores soluções juntos. Harvard Business Review

Discutir de forma saudável é essencial para resolver problemas. E quem não quer resolver problemas, não é mesmo? Na minha terra, quando não temos conhecimento amplo sob determinado assunto, se diz: quem sou eu na fila do pão pra falar DISSO. Logo, vamos direto ao ponto, uma colega compartilhou esse artigo da Harvard Business Review, e eu achei ele muito bom pra o momento atual, pois ele demonstra que a diversidade cognitiva torna um grupo mais inteligente, e eu concluo que um grupo mais inteligente normalmente resolve problemas de forma mais efetiva.

Então, como eu não sou especialista no assunto, vamos para um compilado de algumas partes das dicas do artigo:

Lembre-se de que estamos todos no mesmo time.
Debates onde o objetivo é encontrar as melhores soluções juntos são aqueles onde é possível retirar melhor proveito da diversidade cognitiva, ou seja, aqueles onde ganhamos mais. Então, busque demonstrar seu ponto de vista considerando o posicionamento de investigação ou observação, levar qualquer discurso de ódio e considerar que você está lidando com um adversário é improdutivo e contraproducente, porque os problemas continuam existindo e ninguém resolve nada enquanto busca "vencer" sozinho.
Mantenha-se atento aos fatos lógicos relacionados ao tópico em questão.
As discussões tendem a se fragmentar, especialmente quando as pessoas sentem que suas idéias ou identidades estão sendo atacadas, quase como um instinto pessoal de alto proteção. E os pontos mais importantes são que o debate não é sobre quem se importa mais, é mais poderoso ou articulado. No caso do linkedin não é sobre quem tem mais seguidores, e no caso do dia-a-dia do trabalho não precisa necessariamente ser sobre quem está em uma posição superior, mas sim, pela busca do melhor resultado para o problema. Nesse caso, você pode me perguntar: E quando não há solução? Na minha opinião, quando não há solução há conscientização, e isso é MUITO válido.
Não leve o debate para o pessoal.
A emoção e o ego caminham lado a lado e é muito fácil deixar que eles tomem conta do debate, isso é o que o torna improdutivo. Então, as dicas mais simples e objetivas são evite xingamentos ou ataques pessoais, além disso, dê às pessoas o benefício da dúvida, ou seja, considere o modo que essa pessoa pensa sem antes definir que é alguém ruim ou mau. E sempre considere que ninguém se torna burro ou menos inteligente se mudar de idéia, argumentações saudáveis servem justamente para demonstrar diferentes pontos de vista.
Seja intelectualmente humilde.
Ser intelectualmente humilde é ter a capacidade de mudar de ideia, e considerar os diferentes pontos de vista, além de não levar as coisas para o pessoal, respeitar as pessoas e seu ponto de vista, admitir quando está errado, e se manter curioso para as diferentes e melhores ideias. É importante que a conversa esteja sempre voltada para solução de problemas, e não para busca de um vencedor ou mantenedor do conhecimento.

Essas dicas do artigo são excelentes para o dia-a-dia, e eu particularmente acredito que discussões saudáveis são essenciais para o crescimento intelectual e pessoal. Então, espero que elas te ajudem a continuar levando o seu modo de pensar de forma coesa e concisa.

Curtiu?

Comenta aqui o que você achou :)

6 Boas práticas para o code review

Engenheira Coelho 🐇 — Thu, 07 Oct 2021 19:24:36 +0000

6 Boas práticas para executar no code review

Use emoticons apenas para demonstrar aprovação, por exemplo 👍🏽 , ✅, 🚀, 😊.
Não refatore o PR de outra pessoa sem que ela saiba. Caso sejam necessárias muitas modificações, realize comentários. Refatorar sem informar, retira a oportunidade de aprendizado da pessoa desenvolvedora.
Prefira explicar suas sugestões com pequenos pedaços de código ou links que direcionem a pessoa desenvolvedora.
Sempre que possível responda os comentários no PR. Habilitar a configuração para enviar alerta de novos comentários para o seu e-mail, pode ser uma ótima prática.
Prefira usar linguagem sugestiva à imperativa. Outra boa opção, é utilizar perguntas, por exemplo:

Exemplo 1

❌ ” Ficou ruim ”

✔️ ” É uma ótima prática utilizar nomes mais descritivos. Sugestão: isFlowStateFinished”.

Exemplo 2

❌ ” Nada disso ficou bom”

✔️ ” É mais interessante utilizarmos o padrão do MVC. Você consegue perceber as melhorias associadas? Podemos conversar melhor sobre 😄 ”.

Exemplo 3

❌ ” Esse for está com uma performance ruim”

✔️ ” Utilizar um find() poderia gerar uma performance melhor nesse trecho de código”.

Em PRs maiores ou mais difíceis dê parabéns, ou envie uma mensagem positiva, na aprovação do PR. Trabalhar com desenvolvimento normalmente não é fácil, o incentivo dos colegas é uma prática bem positiva. Apesar de parecer simples, essa prática ajuda na manutenção da cultura e clima.

Curtiu as dicas?

Comenta aqui se você utiliza outras práticas interessantes no code review 😄