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.