I was wondering, how much and if at all, and if not this list, then who is responsible for the documentation pages.
I find some recent additions to the documentation (like this one for example: http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/mx/core/WindowedApplication.html#!JSON.htmlwhich I know is related to the player, not the SDK) to be of shamelessly low quality (see the examples section; I gave someone a link at stackoverflow.com to this page and regretted it, I'd rather write an example then tell a newbe to learn from that page). So, my questions are: - if I find documentation related bugs, who do I tell about it? What's the process / who's responsible for putting stuff online / is Adobe going to provide aggregated documentation on projects it donated? - What is the status of all the AIR classes, that extend framework classes? This is not strictly speaking a documentation issue, but, considering that WindowedApplication depends on mx.core.Application, which is under control of Apache (now / soon), how is that going to be resolved? I'm wondering in particular about documentation, but, obviously, there are other aspects of it too. - I'm not in favor of doing changes, if it's not absolutely needed, but ASDoc is a... *sigh* well, it's easier to throw away, then to fix it, really... I mean, of course it kind of works, but the HTML output it generates is of so very low quality, you want to cry, and fixing it is not particularly easy... - There was that AIR program used for aggregated documentation of all Adobe products. It used to include Flex framework classes. What happens to it? This program was / is quite *controversial* one - in a sense, no one seemed to like her, and as Adobe would explain, it was a result of budget cuts - so that documentation could be rolled out for everyone together, rather then every project handling it's own documentation separately. So will this group be responsible for integrating with that application? IIRC a lot of people were in favor of Eclipse integrated help. Some were making cfh compiles for Windows etc. because that AIR application wasn't really usable. So, is this group bound by any promises to keep that thing alive? - Finally, there were online resources such as Flex Developer Manual, Flex User Manual. They were sided in a sense they discussed framework in connection to Flash Builder, but they are not making too many cross-references. Anyway, is Adobe going to keep that alive too, or is it under Apache jurisdiction now / soon? - Just to elaborate on this, beside the manuals themselves, there exists a kind of forum / user provided feedback feature with community help etc. It's not particularly lively forum, yet there's daily activity of about 10 messages a day. I'm not sure about what happens to this project, who's taking over it etc. Any thoughts? - Are there any ideas about what / what kind of documentation / user interaction is Apache going to provide to the users? Is it going to leverage user manuals? Best. Oleg
