The principle is clarity: a code review should show the next priority.
O princípio é clareza: uma revisão de código deve mostrar a próxima prioridade.
Feedback C1 que ajuda a crescer
Primeira vez aqui?
Cada tema tem etapas curtas, uma de cada vez.Esta é a primeira: a Aula. Quando terminar de ler, toque em Concluir aula e ir ao vocabulário. Seu progresso fica salvo sozinho — pode sair e voltar quando quiser.
Precisa de uma fonte mais confortável? Abra Menu → Preferências.
Tema 178 · Aula
Você vai aprender estas frases
Ouça cada frase e tente repeti-la.
Se quiser, grave sua voz para comparar. A gravação não é enviada.
For example, the pull request explains the change but not the failure mode it protects against.
Por exemplo, o pull request explica a mudança, mas não o modo de falha contra o qual ela protege.
Ver dica
Apresenta um exemplo observável.One possible improvement would be to add a test for the blocked request.
Uma possível melhoria seria acrescentar um teste para a solicitação bloqueada.
Ver dica
Propõe uma alternativa concreta.The rationale is that future maintainers can understand the risk without guessing.
A justificativa é que futuras pessoas mantenedoras podem entender o risco sem adivinhar.
Ver dica
Explica o efeito da alternativa.Nível: C1
Objetivo
Dar e receber feedback C1 que ajuda a crescer em código, design ou documentação, usando princípio, exemplo, alternativa e rationale para preservar a relação.
Explicação
Feedback técnico que ajuda a crescer combina respeito com precisão sobre a ação. Comece pelo princípio, mostre um exemplo observável, proponha uma alternativa e explique por que ela ajuda. Use I noticed... e One possible improvement would be.... Receber feedback também exige pedir um exemplo e escolher uma próxima ação, sem transformar um problema de código em julgamento pessoal.
Erros comuns
- Transformar uma lacuna no código em crítica pessoal ao autor.
- Dizer que algo está confuso sem apontar um exemplo observável no diff.
- Propor uma mudança sem explicar seu efeito sobre confiabilidade ou manutenção.
- Usar jargão ou detalhes privados que impedem uma conversa respeitosa.
Prática guiada
Escolha um pull request fictício; dê feedback com princípio, exemplo, alternativa e rationale, peça a perspectiva do colega e combine uma próxima ação.
Resumo
Feedback técnico útil separa ação, efeito e alternativa: princípio, exemplo, rationale e próximo passo preservam a relação.
Dar e receber feedback C1 que ajuda a crescer em código, design ou documentação, usando princípio, exemplo, alternativa e rationale para preservar a relação.
Registre sua percepção. Isso não prova domínio, não muda sua nota e não bloqueia o próximo tema.