Documentar é uma arte, amigo.
A maioria dos programadores nem é capaz de fazê-lo com qualidade.
Comentar o código é a coisa mais prática, e a documentação acaba ficando mais pra setups ou pontos de configuração mais específicos.