incubator-flex-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Left Right <olegsivo...@gmail.com>
Subject Language Reference Online Materials
Date Tue, 20 Mar 2012 21:59:31 GMT
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

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message