Cara seguindo as boas praticas comentar código é uma má pratica a não ser que ele seja necessario, basicamente você vai comentar um código que alguem não vai entender o que faz só de olhar, ou seja, se você esta comentando seu codigo é porque ele esta sujo. Possa ser que eu esteja sendo ignorante ou apenas seguidor fiel do clean code mas cara faz sentido. Pensa se teu codigo não estará legivel pros outros só pra ti, quando alguem precisar fazer uma manutenção ali as vezes mesmo com teu comentario pode ser dificil saber onde mexer no codigo entende? Coisas como SOLID, TDD, testes unitarios de integração etc, podem parecer até inuteis mas são valioso na hora de codar.

Gostaria só de falar sobre essa parte de documentação, recentemente eu vi algo que faz sentido: Testes únitarios servem de documentação de programador para programador. Obviamente que isso não isenta de fazer a parte de documentação real do código, mas testes únitarios são boas praticas que te economizam tempo no futuro sabe. Enfim.