Stackoverflow has now an ActionScript 3 documentation dashboard
So it seems stackoverflow want to go into the community edited wiki on top of the Q/A forums they have been known for, ok ... maybe.
As much as I go into the idea of any documentation available is good enough, if you can give credits to Adboe for one thing is the freaking good documentation
The ActionScript® 3.0 Reference for the Adobe® Flash® Platform contains the ActionScript language elements, core libraries, and component packages and classes for the tools, runtimes, services and servers in the Flash Platform.
So before of the above stackoverflow thingy I would advice to look into those things first:
Adobe Flash Platform official documentation
eg. "ActionScript 3.0 Developer's Guide" or the infamous AS3LCR (Language Core Reference)
the pros are that it is a pretty damn good documentation from the mothership itself, that you can download it as PDF (portable, local, even works on mobile reader).
the cons is that people prefer to go ask a quick question on stackoverflow instead of reading the damn doc.
ActionScript 3.0 Reference for the Adobe Flash Platform
the pros are the tons of examples (thanks to asdoc), the always updated reference, the selection of runtime versions and the redirection to topics into many of the Adobe official documentations (above).
the cons are well ... some things are kept out of the documentation like the Proxy class, the IExternalizable interface, and other "strange things" like
avm2.intrinsics.memory etc. and there are no user comments.
Adobe Developer Connection
- tons of blog posts and articles from Adobe employees, here few examples
- tons of blog posts (even the very old ones), preso and articles from AS3 dev, here few examples
Now there are some problem, old posts have a tendency to die because of the dreaded Internet rotten links
see the "AIR API Overview presentation" above?
well... you can find a blog post here AIR Tips and Tricks – Video, Slides, and Code, the PDF of the presentation and the source code are still available but the video of the presentation that is located here http://onair.adobe.com/blogs/videos/2008/06/24/daniel-duras-air-apis-session-from-munich/ redirect to http://www.adobe.com/products/air.html
Same for all the content that was on tv.adobe.com , it's all gone (anybody know if those videos been archived somewhere?).
So yeah I would personally favour all of these above than this stackoverflow documentation, in fact I do keep archived copy of many things like preso as PDF and other articles, not that new content is a bad thing but I think it is a shame to lost something that has already been written somewhere, and a bit useless to start from scratch on a platform (like stackoverflow) that ultimately could vanish too.
Now I would say for ActionScript 3.0 and as3lang in general yeah finding a way to write new documentation about maybe less documented thing and other obscurs stuff could be useful, I kindof already started here as3lang/ActionScript3, the idea being that a github repo can easily be shared between different doc writers, nobody own the content or at least you can fork/export and yeah it is open source so it had better chances to survive the rotten links.
With Redtamarin I do try to include in the generated documentation (from asdoc) all the things that Adobe does not document in the AS3LCR, like
avm2.intrinsics.memory for example.
And with as3lang/ActionScript3 the idea is more about synthesizing many sources into one consistant documentation, for example the usage of
[embed] especially with font (well.. it's on the wiki pages and more like a draft than a full blown doc).
Ideally I would want something to contain more structured examples on how to do specific things, from personal documentation work I dabbled a lot in markdown to PDF/HTML documentation (with pandoc, gitbook, etc.), with Redtamarin I also went in-depth reusing every bit of asdoc, and ultimately a mix of all that could imho produce good docs.