Em termos de funcionalidade, o gerador de documentação que mais entrega o que se espera é o famoso JSDoc, que é basicamente uma cópia do Javadoc.
Entretanto, ele apresenta 2 problemas fundamentais: dificuldade de se customizar a documentação e poluição severa do código-fonte com comentários.
/**