I’ve been enjoying my time fighting pretty hard since yesterday with this awesome piece of c… that is ASDoc. Basically, it’s a user-friendly GUI command-line app provided with Flex sdks. Its purpose is to help give hell to the developer by automatically creating the API documentation of a project. The process is pretty much straightforward excruciating and above all the app is very reliable buggy.
Anyway, ASDoc is what people use to generate docs, and most of it it generates docs with AS classes AND MXML files. That’s a new feature of Gumbo (Flex 4) sdk and that was one of the reasons I kept fighting and not just dropped everything and simply used VisDoc. VisDoc works pretty well, is reliable, but doesn’t generate any documentation about mxml files. Also, it’s a Mac only software which is not perfect as my colleagues use Windows (idiots).
So basically the idea is to try and use ASDoc as much as the picky thing accepts to generate the documentation. And use VisDoc when it doesn’t.

Continue Reading…