Comentário bom explica por que, não repete o que a linha já diz
Aprenda a separar o comentário que envelhece mentindo do que salva a próxima pessoa: restrição externa, regra de negócio, contorno com prazo. Com exemplos em Python antes e depois.
Programação
399 artigos nesta categoria.
Nome de função que mente: validar que grava, buscar que cria
Renomeie funções para que o nome diga o efeito real: separe consulta de comando, escolha verbos com contrato claro e troque o nome sem quebrar quem já chama.
Parâmetro booleano solto: por que emitirFatura(f, true, false) é uma armadilha
Troque booleanos posicionais por objeto de opções, funções separadas ou tipos com nome, em TypeScript e Python, para que a chamada se leia sem abrir a definição.
Null virando zero: JS, PHP, Python, C# e SQL testados
Onde null, vazio e campo ausente viram 0 em JavaScript, PHP, Python, C#, MySQL e PostgreSQL, com leitura de preço segura e o CHECK que deixa NULL passar.
Teste que quebra na virada do mês: injete o relógio e teste a fronteira
Tire o relógio real dos seus testes, fixe o instante que importa e cubra dia 31, 29 de fevereiro e meia-noite antes que o CI descubra por você.
Teste que só passa sozinho: como achar e cortar o estado compartilhado
Descubra qual teste está vazando estado para o vizinho, rode a suíte em ordem aleatória e faça cada teste preparar e limpar o próprio dado.
Fixture gigante esconde a regra: monte só o dado que o teste usa
Troque o JSON de cem linhas por um construtor de dados com padrões sensatos e deixe no teste só o campo que decide o resultado.
Mock que mente: teste verde, produção vermelha e o teste de contrato que evita
Use dublê para isolar a sua regra e um teste de contrato com resposta real gravada para descobrir quando o fornecedor muda antes do cliente descobrir.
Cobertura de 100% sem assert: como saber se o teste verifica alguma coisa
Entenda o que a cobertura mede, ache testes que executam sem afirmar nada e use mutação, manual ou com ferramenta, para medir se a suíte pega bug.
Domínio do cookie: login que some entre www e apex ou vaza para subdomínio
Entenda quando o cookie vale só para o host e quando vale para todo subdomínio, escolha o escopo certo da sessão e use o prefixo __Host- para travar.
Um h1 por página e cabeçalhos em ordem: a estrutura que leitor de tela entende
Arrume a hierarquia de cabeçalhos do seu template: um h1 com o assunto da página, seções em h2 e h3 sem pular nível, e o visual resolvido no CSS.
ASP.NET atrás de proxy no Docker: o cadeado fica na borda e a app precisa saber
Termine o TLS no proxy, configure os forwarded headers do ASP.NET para confiar só nele e acabe com loop de redirect, cookie sem Secure e redirect_uri em http.