TODO, FIXME e comentários que apodrecem
Pergunta
Comentários `// TODO` e `// FIXME` acumulam no código sem nunca serem feitos. Como lidar com isso de forma que não vire lixo?
Resposta esperada
Um TODO solto é um lembrete sem dono e sem prazo — em seis meses ninguém sabe se ainda vale, quem sabia saiu, e ele vira ruído que todo mundo aprende a ignorar. Práticas: (1) TODO com contexto e link — `// TODO(#4521): remover quando a API v1 for desligada` — dá pra rastrear e fechar; (2) se é trabalho real, vira um ticket de verdade, não um comentário; (3) linter/CI que bloqueia `FIXME` sem número de issue, ou que falha se há TODOs mais velhos que X; (4) revisar TODOs periodicamente e apagar os obsoletos sem dó. O anti-padrão é o TODO como desculpa pra mergear código que você sabe que está incompleto sem registrar isso em lugar nenhum além de uma linha que só quem abrir o arquivo vê.
Por que perguntam isso
Pergunta pleno. Sinal bom: 'vira ticket, não comentário' e o CI barrando FIXME sem número.