Olá pessoal, devo devo gerar a documentação do meu código de teste? (com javaDoc). Ou apenas deixo comentários?
Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!
Olá pessoal, devo devo gerar a documentação do meu código de teste? (com javaDoc). Ou apenas deixo comentários?
Oi Israel,
Não existe uma regra. Particularmente eu não documento nem faço comentários (muitos desenvolvedores adotam essa prática). Costumo dar nomes bem semânticos para os testes (métodos e classes), pois quando um quebrar o desenvolvedor saiba exatamente o que deve investigar, algo como:
public class FuncionarioDaoTest {
@Test
public void listaOsFuncionariosEmOrdemAlfabetica() {
...
}
}