Remoting for AS2 + a Doc format?

Yesterday, Macromedia silently released the updated Remoting components for Flash MX04. They are long over due, offer few surprises, but have been sorely missed.

The components actually took so long that many business professionals almost thought that Remoting would go the way of Generator, but Macromedia were quickly on the spot to assure that Remoting was here to stay. The new components are only for use with Actionscript 2.0 projects.

The new components are built using AS2 and the source code is also available for study. The source-code is for some reason full of trace-commands and other debug information? Most coders remove these before publishing.

With the release of the new Remoting components, Macromedia mention that they feature the "new ASDoc format". Ever since actionscript arrived, coders have found their own way of documenting Flash projects. Now, Macromedia has apparently figured that they have to follow suit - and make up something to document their own work. We look forward to seeing an application that can actually make the docs too.

As usual with Macromedia, the specs for ASDoc are undocumented. Kind of ironic, since documentation should prevent exactly that. We look forward to hearing Macromedia explain about ASDoc at the "Macromedia Flash Developer Center". In that article, they can explain why the did not do like others before them and tried to make the documentation more standard, like JavaDoc. Support for class referencing using the @see keyword would have been great. Then we could finally see the dependencies between classes. The ability to add examples to the documentation would also be nice, rather than the unexpandable helpids that apparently have been added now.

Update: Mike Downey comments on ASDoc.
Read more / download

 

 

Comments

No comments for this page.

Submit a comment

Only registered members can comment. Click the link at the top of this page to register.