O mais legal de um código bem escrito, organizado e com namespaces adequados, é que ele é auto documentado, dispensando qualquer comentário.
Basta lermos o código/função e já sabemos o que faz e qual a sua finalidade.
Parabéns.