A cartilha do “bom programador” sempre prega que para manter seu código padronizado e legível precisa-se sempre utilizar linhas de comentários para auxílio próprio ou mesmo para que terceiros entendam facilmente sua implementação e possam dar continuidade a ela. Quanto maior o sistema, maior o número de linhas de código e consequentemente maior a complexidade. Para “digerir” melhor essa complexidade o bom uso de comentários é fundamental.
E para comentar um código de forma padronizada e organizada nós temos algumas regras, que apesar de serem relativamente simples, podem ajudar bastante no processo de documentação de códigos.