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.