O péssimo estado das ferramentas de documentação Javascript

Recentemente, tenho procurado em toda a rede pela One True
Way para documentar programas Javascript e devo dizer que estou um pouco
decepcionado. Resumindo, tenho os seguintes requisitos para
documentar Backgrid.js :

  • Resumo autom√°tico da API com base na assinatura da fun√ß√£o
  • Capaz de compreender e documentar express√Ķes comuns de JS, como throwestender um prot√≥tipo com um objeto literal, disparar eventos … etc.
  • Exemplos de c√≥digo incorporado no Markdown
  • D√° mensagens de erro razo√°veis
  • Salva informa√ß√Ķes de documenta√ß√£o analisadas em alguns arquivos JSON de metadados

Você poderia pensar que muitas ferramentas fazem isso (porque eles afirmam que
podem), mas aqui est√° a realidade:

Leia mais no meu Blog Posterous