Uma das grandes deficiências do Flash, é a parte de documentação do código ActionScript.
O editor do Flash não possui nenhum tipo de ferramenta que provê documentação, ou definições de documentação para ser incorporado no código como é feito com o Java / Javadoc.

Sendo assim, para que nós possamos documentar os nossos códigos decentemente precisamos de iniciativas externas.
A empresa B-Line Express desenvolveu uma espécie de javadoc para arquivos ActionScript.
BLDoc é gerador de documentação para ActionScript 2.0. Com ele é possível gerar uma série de arquivos HTMLs para exibição bem parecida com o Javadoc, além de ser uma ferramenta free.
Lembrando, também, que as palavras reservadas da documentação do BLDoc são as mesmas do Javadoc, então para quem já conhece a iniciativa da Sun na documentação de códigos em Java, não terá dificuldade no uso desta ferramenta.

O editor SE|PY dá suporte nativo ao Javadoc, então com ele é muito simples incorporar tags de documentação nos seus arquivos .AS, isso devido ao uso do intellisense.

Aquele abraço