You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@flex.apache.org by Michael Schmalle <ap...@teotigraphix.com> on 2013/01/14 11:12:00 UTC
[DISCUSS] website asdocs
Having the asdoc in the site folder, is this a good idea?
The seems really wrong on a gut level to me but I don't have another
solution at the moment. I am sitting still waiting on a broadband
connection just to change my site info. This is also why I only
selectively check out whiteboard folders so I don't get multiple
copied branches of the 10000's of framework files and tests.
In reply to the Flash docs, IMHO me a re screwed and another reason to
keep running from Adobe. :) Since I have been working on a new ASDOc
tool/program I can see using the SWCs API to create the entries and
links in the docs but have links in them to the Adobe live docs.
This way you would get the api right in fornt of you all the way up to
Object but not the descriptions.
Mike
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
Re: [DISCUSS] website asdocs
Posted by Nicholas Kwiatkowski <ni...@spoon.as>.
No, but I didn't ask. I can ask in IRC tonight and see what their opinion
is on it.
-Nick
On Mon, Jan 14, 2013 at 1:39 PM, Alex Harui <ah...@adobe.com> wrote:
> Sorry, when I said SVN, I meant under a different folder than CMS currently
> watches, like a sibling of asjs, falcon, etc. SVN knows how to serve those
> files. Did Infra explicitly say we can't explode it on dist? That's
> another server we have write access to.
>
>
> On 1/14/13 10:02 AM, "Nicholas Kwiatkowski" <ni...@spoon.as> wrote:
>
> > When I say "CMS", I am pretty much talking about our SVN as the
> repository.
> > The CMS (buildbot) copies content from the SVN to its directories.
> While
> > it is coping, it checks each file for matches to the path strings we give
> > and if they match, it does magic to it.
> >
> > I guess we could put it on people, but I doubt that is kosher for
> something
> > that is for the project...
> >
> > -Nick
> >
> > On Mon, Jan 14, 2013 at 12:28 PM, Alex Harui <ah...@adobe.com> wrote:
> >
> >> What do you really mean by "on our website"? Couldn't we point to a
> copy
> >> on
> >> people@a.o or even in our SVN?
> >>
> >>
> >> On 1/14/13 5:08 AM, "Nicholas Kwiatkowski" <ni...@spoon.as> wrote:
> >>
> >>> Unfortunately, the only way to get stuff to our website is through the
> >> CMS.
> >>> Infra hasn't given us any other options, and from a legal standpoint,
> I
> >>> would rather keep them on our domain.
> >>>
> >>> -Nick
> >>>
> >>> On Mon, Jan 14, 2013 at 7:59 AM, Michael Schmalle
> >>> <ap...@teotigraphix.com>wrote:
> >>>
> >>>> I wasn't debating the fact that asdocs need to be public, I was
> >>>> questioning if having them in the CMS is our only option.
> >>>>
> >>>> As you said, republishing them kills the build and that proves there
> >> must
> >>>> be some other option or hosting solution.
> >>>>
> >>>> Mike
> >>>>
> >>>>
> >>>> Quoting Nicholas Kwiatkowski <ni...@spoon.as>:
> >>>>
> >>>> Personally, I like having the ASDocs on the website (and therefore,
> we
> >>>>> have
> >>>>> to have it in the SVN). Otherwise I have to download 8 copies for
> my 8
> >>>>> different machines. I asked infra on IRC to see about the
> possibility
> >> to
> >>>>> get a "help.flex.apache.org" that wasn't run through the CMS or
> >> something
> >>>>> to that effect, and they didn't like the idea..
> >>>>>
> >>>>> By the way, when anybody updates the ASdocs, the CMS will take about
> 2
> >>>>> hours to process it. It also causes the buildbot process to crash ;S
> >>>>>
> >>>>> -Nick
> >>>>>
> >>>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
> >>>>> <ap...@teotigraphix.com>**wrote:
> >>>>>
> >>>>>
> >>>>>> Having the asdoc in the site folder, is this a good idea?
> >>>>>>
> >>>>>> The seems really wrong on a gut level to me but I don't have another
> >>>>>> solution at the moment. I am sitting still waiting on a broadband
> >>>>>> connection just to change my site info. This is also why I only
> >>>>>> selectively
> >>>>>> check out whiteboard folders so I don't get multiple copied branches
> >> of
> >>>>>> the
> >>>>>> 10000's of framework files and tests.
> >>>>>>
> >>>>>> In reply to the Flash docs, IMHO me a re screwed and another reason
> to
> >>>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
> >>>>>> tool/program I can see using the SWCs API to create the entries and
> >> links
> >>>>>> in the docs but have links in them to the Adobe live docs.
> >>>>>>
> >>>>>> This way you would get the api right in fornt of you all the way up
> to
> >>>>>> Object but not the descriptions.
> >>>>>>
> >>>>>> Mike
> >>>>>>
> >>>>>> --
> >>>>>> Michael Schmalle - Teoti Graphix, LLC
> >>>>>> http://www.teotigraphix.com
> >>>>>> http://blog.teotigraphix.com
> >>>>>>
> >>>>>>
> >>>>>>
> >>>>>
> >>>> --
> >>>> Michael Schmalle - Teoti Graphix, LLC
> >>>> http://www.teotigraphix.com
> >>>> http://blog.teotigraphix.com
> >>>>
> >>>>
> >>
> >> --
> >> Alex Harui
> >> Flex SDK Team
> >> Adobe Systems, Inc.
> >> http://blogs.adobe.com/aharui
> >>
> >>
>
> --
> Alex Harui
> Flex SDK Team
> Adobe Systems, Inc.
> http://blogs.adobe.com/aharui
>
>
Re: [DISCUSS] website asdocs
Posted by Alex Harui <ah...@adobe.com>.
Sorry, when I said SVN, I meant under a different folder than CMS currently
watches, like a sibling of asjs, falcon, etc. SVN knows how to serve those
files. Did Infra explicitly say we can't explode it on dist? That's
another server we have write access to.
On 1/14/13 10:02 AM, "Nicholas Kwiatkowski" <ni...@spoon.as> wrote:
> When I say "CMS", I am pretty much talking about our SVN as the repository.
> The CMS (buildbot) copies content from the SVN to its directories. While
> it is coping, it checks each file for matches to the path strings we give
> and if they match, it does magic to it.
>
> I guess we could put it on people, but I doubt that is kosher for something
> that is for the project...
>
> -Nick
>
> On Mon, Jan 14, 2013 at 12:28 PM, Alex Harui <ah...@adobe.com> wrote:
>
>> What do you really mean by "on our website"? Couldn't we point to a copy
>> on
>> people@a.o or even in our SVN?
>>
>>
>> On 1/14/13 5:08 AM, "Nicholas Kwiatkowski" <ni...@spoon.as> wrote:
>>
>>> Unfortunately, the only way to get stuff to our website is through the
>> CMS.
>>> Infra hasn't given us any other options, and from a legal standpoint, I
>>> would rather keep them on our domain.
>>>
>>> -Nick
>>>
>>> On Mon, Jan 14, 2013 at 7:59 AM, Michael Schmalle
>>> <ap...@teotigraphix.com>wrote:
>>>
>>>> I wasn't debating the fact that asdocs need to be public, I was
>>>> questioning if having them in the CMS is our only option.
>>>>
>>>> As you said, republishing them kills the build and that proves there
>> must
>>>> be some other option or hosting solution.
>>>>
>>>> Mike
>>>>
>>>>
>>>> Quoting Nicholas Kwiatkowski <ni...@spoon.as>:
>>>>
>>>> Personally, I like having the ASDocs on the website (and therefore, we
>>>>> have
>>>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>>>> different machines. I asked infra on IRC to see about the possibility
>> to
>>>>> get a "help.flex.apache.org" that wasn't run through the CMS or
>> something
>>>>> to that effect, and they didn't like the idea..
>>>>>
>>>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>>>> hours to process it. It also causes the buildbot process to crash ;S
>>>>>
>>>>> -Nick
>>>>>
>>>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>>>> <ap...@teotigraphix.com>**wrote:
>>>>>
>>>>>
>>>>>> Having the asdoc in the site folder, is this a good idea?
>>>>>>
>>>>>> The seems really wrong on a gut level to me but I don't have another
>>>>>> solution at the moment. I am sitting still waiting on a broadband
>>>>>> connection just to change my site info. This is also why I only
>>>>>> selectively
>>>>>> check out whiteboard folders so I don't get multiple copied branches
>> of
>>>>>> the
>>>>>> 10000's of framework files and tests.
>>>>>>
>>>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>>>> tool/program I can see using the SWCs API to create the entries and
>> links
>>>>>> in the docs but have links in them to the Adobe live docs.
>>>>>>
>>>>>> This way you would get the api right in fornt of you all the way up to
>>>>>> Object but not the descriptions.
>>>>>>
>>>>>> Mike
>>>>>>
>>>>>> --
>>>>>> Michael Schmalle - Teoti Graphix, LLC
>>>>>> http://www.teotigraphix.com
>>>>>> http://blog.teotigraphix.com
>>>>>>
>>>>>>
>>>>>>
>>>>>
>>>> --
>>>> Michael Schmalle - Teoti Graphix, LLC
>>>> http://www.teotigraphix.com
>>>> http://blog.teotigraphix.com
>>>>
>>>>
>>
>> --
>> Alex Harui
>> Flex SDK Team
>> Adobe Systems, Inc.
>> http://blogs.adobe.com/aharui
>>
>>
--
Alex Harui
Flex SDK Team
Adobe Systems, Inc.
http://blogs.adobe.com/aharui
Re: [DISCUSS] website asdocs
Posted by Nicholas Kwiatkowski <ni...@spoon.as>.
When I say "CMS", I am pretty much talking about our SVN as the repository.
The CMS (buildbot) copies content from the SVN to its directories. While
it is coping, it checks each file for matches to the path strings we give
and if they match, it does magic to it.
I guess we could put it on people, but I doubt that is kosher for something
that is for the project...
-Nick
On Mon, Jan 14, 2013 at 12:28 PM, Alex Harui <ah...@adobe.com> wrote:
> What do you really mean by "on our website"? Couldn't we point to a copy
> on
> people@a.o or even in our SVN?
>
>
> On 1/14/13 5:08 AM, "Nicholas Kwiatkowski" <ni...@spoon.as> wrote:
>
> > Unfortunately, the only way to get stuff to our website is through the
> CMS.
> > Infra hasn't given us any other options, and from a legal standpoint, I
> > would rather keep them on our domain.
> >
> > -Nick
> >
> > On Mon, Jan 14, 2013 at 7:59 AM, Michael Schmalle
> > <ap...@teotigraphix.com>wrote:
> >
> >> I wasn't debating the fact that asdocs need to be public, I was
> >> questioning if having them in the CMS is our only option.
> >>
> >> As you said, republishing them kills the build and that proves there
> must
> >> be some other option or hosting solution.
> >>
> >> Mike
> >>
> >>
> >> Quoting Nicholas Kwiatkowski <ni...@spoon.as>:
> >>
> >> Personally, I like having the ASDocs on the website (and therefore, we
> >>> have
> >>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
> >>> different machines. I asked infra on IRC to see about the possibility
> to
> >>> get a "help.flex.apache.org" that wasn't run through the CMS or
> something
> >>> to that effect, and they didn't like the idea..
> >>>
> >>> By the way, when anybody updates the ASdocs, the CMS will take about 2
> >>> hours to process it. It also causes the buildbot process to crash ;S
> >>>
> >>> -Nick
> >>>
> >>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
> >>> <ap...@teotigraphix.com>**wrote:
> >>>
> >>>
> >>>> Having the asdoc in the site folder, is this a good idea?
> >>>>
> >>>> The seems really wrong on a gut level to me but I don't have another
> >>>> solution at the moment. I am sitting still waiting on a broadband
> >>>> connection just to change my site info. This is also why I only
> >>>> selectively
> >>>> check out whiteboard folders so I don't get multiple copied branches
> of
> >>>> the
> >>>> 10000's of framework files and tests.
> >>>>
> >>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
> >>>> keep running from Adobe. :) Since I have been working on a new ASDOc
> >>>> tool/program I can see using the SWCs API to create the entries and
> links
> >>>> in the docs but have links in them to the Adobe live docs.
> >>>>
> >>>> This way you would get the api right in fornt of you all the way up to
> >>>> Object but not the descriptions.
> >>>>
> >>>> Mike
> >>>>
> >>>> --
> >>>> Michael Schmalle - Teoti Graphix, LLC
> >>>> http://www.teotigraphix.com
> >>>> http://blog.teotigraphix.com
> >>>>
> >>>>
> >>>>
> >>>
> >> --
> >> Michael Schmalle - Teoti Graphix, LLC
> >> http://www.teotigraphix.com
> >> http://blog.teotigraphix.com
> >>
> >>
>
> --
> Alex Harui
> Flex SDK Team
> Adobe Systems, Inc.
> http://blogs.adobe.com/aharui
>
>
Re: [DISCUSS] website asdocs
Posted by Alex Harui <ah...@adobe.com>.
What do you really mean by "on our website"? Couldn't we point to a copy on
people@a.o or even in our SVN?
On 1/14/13 5:08 AM, "Nicholas Kwiatkowski" <ni...@spoon.as> wrote:
> Unfortunately, the only way to get stuff to our website is through the CMS.
> Infra hasn't given us any other options, and from a legal standpoint, I
> would rather keep them on our domain.
>
> -Nick
>
> On Mon, Jan 14, 2013 at 7:59 AM, Michael Schmalle
> <ap...@teotigraphix.com>wrote:
>
>> I wasn't debating the fact that asdocs need to be public, I was
>> questioning if having them in the CMS is our only option.
>>
>> As you said, republishing them kills the build and that proves there must
>> be some other option or hosting solution.
>>
>> Mike
>>
>>
>> Quoting Nicholas Kwiatkowski <ni...@spoon.as>:
>>
>> Personally, I like having the ASDocs on the website (and therefore, we
>>> have
>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>> different machines. I asked infra on IRC to see about the possibility to
>>> get a "help.flex.apache.org" that wasn't run through the CMS or something
>>> to that effect, and they didn't like the idea..
>>>
>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>> hours to process it. It also causes the buildbot process to crash ;S
>>>
>>> -Nick
>>>
>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>> <ap...@teotigraphix.com>**wrote:
>>>
>>>
>>>> Having the asdoc in the site folder, is this a good idea?
>>>>
>>>> The seems really wrong on a gut level to me but I don't have another
>>>> solution at the moment. I am sitting still waiting on a broadband
>>>> connection just to change my site info. This is also why I only
>>>> selectively
>>>> check out whiteboard folders so I don't get multiple copied branches of
>>>> the
>>>> 10000's of framework files and tests.
>>>>
>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>> tool/program I can see using the SWCs API to create the entries and links
>>>> in the docs but have links in them to the Adobe live docs.
>>>>
>>>> This way you would get the api right in fornt of you all the way up to
>>>> Object but not the descriptions.
>>>>
>>>> Mike
>>>>
>>>> --
>>>> Michael Schmalle - Teoti Graphix, LLC
>>>> http://www.teotigraphix.com
>>>> http://blog.teotigraphix.com
>>>>
>>>>
>>>>
>>>
>> --
>> Michael Schmalle - Teoti Graphix, LLC
>> http://www.teotigraphix.com
>> http://blog.teotigraphix.com
>>
>>
--
Alex Harui
Flex SDK Team
Adobe Systems, Inc.
http://blogs.adobe.com/aharui
Re: [DISCUSS] website asdocs
Posted by Nicholas Kwiatkowski <ni...@spoon.as>.
Unfortunately, the only way to get stuff to our website is through the CMS.
Infra hasn't given us any other options, and from a legal standpoint, I
would rather keep them on our domain.
-Nick
On Mon, Jan 14, 2013 at 7:59 AM, Michael Schmalle
<ap...@teotigraphix.com>wrote:
> I wasn't debating the fact that asdocs need to be public, I was
> questioning if having them in the CMS is our only option.
>
> As you said, republishing them kills the build and that proves there must
> be some other option or hosting solution.
>
> Mike
>
>
> Quoting Nicholas Kwiatkowski <ni...@spoon.as>:
>
> Personally, I like having the ASDocs on the website (and therefore, we
>> have
>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>> different machines. I asked infra on IRC to see about the possibility to
>> get a "help.flex.apache.org" that wasn't run through the CMS or something
>> to that effect, and they didn't like the idea..
>>
>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>> hours to process it. It also causes the buildbot process to crash ;S
>>
>> -Nick
>>
>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>> <ap...@teotigraphix.com>**wrote:
>>
>>
>>> Having the asdoc in the site folder, is this a good idea?
>>>
>>> The seems really wrong on a gut level to me but I don't have another
>>> solution at the moment. I am sitting still waiting on a broadband
>>> connection just to change my site info. This is also why I only
>>> selectively
>>> check out whiteboard folders so I don't get multiple copied branches of
>>> the
>>> 10000's of framework files and tests.
>>>
>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>> tool/program I can see using the SWCs API to create the entries and links
>>> in the docs but have links in them to the Adobe live docs.
>>>
>>> This way you would get the api right in fornt of you all the way up to
>>> Object but not the descriptions.
>>>
>>> Mike
>>>
>>> --
>>> Michael Schmalle - Teoti Graphix, LLC
>>> http://www.teotigraphix.com
>>> http://blog.teotigraphix.com
>>>
>>>
>>>
>>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>
Re: [DISCUSS] website asdocs
Posted by Michael Schmalle <ap...@teotigraphix.com>.
I wasn't debating the fact that asdocs need to be public, I was
questioning if having them in the CMS is our only option.
As you said, republishing them kills the build and that proves there
must be some other option or hosting solution.
Mike
Quoting Nicholas Kwiatkowski <ni...@spoon.as>:
> Personally, I like having the ASDocs on the website (and therefore, we have
> to have it in the SVN). Otherwise I have to download 8 copies for my 8
> different machines. I asked infra on IRC to see about the possibility to
> get a "help.flex.apache.org" that wasn't run through the CMS or something
> to that effect, and they didn't like the idea..
>
> By the way, when anybody updates the ASdocs, the CMS will take about 2
> hours to process it. It also causes the buildbot process to crash ;S
>
> -Nick
>
> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
> <ap...@teotigraphix.com>wrote:
>
>>
>> Having the asdoc in the site folder, is this a good idea?
>>
>> The seems really wrong on a gut level to me but I don't have another
>> solution at the moment. I am sitting still waiting on a broadband
>> connection just to change my site info. This is also why I only selectively
>> check out whiteboard folders so I don't get multiple copied branches of the
>> 10000's of framework files and tests.
>>
>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>> keep running from Adobe. :) Since I have been working on a new ASDOc
>> tool/program I can see using the SWCs API to create the entries and links
>> in the docs but have links in them to the Adobe live docs.
>>
>> This way you would get the api right in fornt of you all the way up to
>> Object but not the descriptions.
>>
>> Mike
>>
>> --
>> Michael Schmalle - Teoti Graphix, LLC
>> http://www.teotigraphix.com
>> http://blog.teotigraphix.com
>>
>>
>
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
RE: [DISCUSS] website asdocs
Posted by Frédéric THOMAS <we...@hotmail.com>.
It would be nice.
-----Original Message-----
From: Michael Schmalle [mailto:apache@teotigraphix.com]
Sent: Monday, January 14, 2013 3:03 PM
To: dev@flex.apache.org
Subject: Re: [DISCUSS] website asdocs
Actually, I have to check into this but if adobe has publicly available SWCs
that the new asdoc generator could load and parse the DITA with their
documentation, adding Flash Player documentation is possible.
I'm speaking from ignorance here and I would have to investigate if the
playerglobal.swc somewhere has asdocs embedded.
Mike
Quoting Michael Schmalle <ap...@teotigraphix.com>:
>
> Quoting Harbs <ha...@gmail.com>:
>
>> Maybe, but there is the issue of the missing core classes (which I
>> mentioned in the other thread I started).
>
> I answered this, the only way to get core classes is by creating a new
> asdoc that parses and renders the API from SWCs which I know is
> possible, this way you get the API. I see no real option of getting
> the descriptions with those, only code generated links that point to
> the Adobe livedocs for each member etc which would be really akward.
>
>
>> I've also used the filter in the Adobe ASDocs based on Flash/AIR
>> version on occasion. For the classes where it matters, those filters
>> are useful.
>
> The current template for asdoc does not have all the JavaScript for
> filtering. At the moment this is impossible.
>
>
>> If we're picking the ASDocs apart, I'd add a padding to the Apache
>> Flex logo at the top right and probably make it a bit smaller?
>
> I just updated the image, I'm definitely not a web designer.
>
>
>> Harbs
>>
>> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>>
>>> I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has less
>>> clutter than the adobe ones and load faster.
>>>
>>>
>>>
>>> -----Original Message-----
>>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>>> Sent: Monday, January 14, 2013 7:55
>>> To: dev@flex.apache.org
>>> Subject: Re: [DISCUSS] website asdocs
>>>
>>> Personally, I like having the ASDocs on the website (and therefore,
>>> we have to have it in the SVN). Otherwise I have to download 8
>>> copies for my 8 different machines. I asked infra on IRC to see
>>> about the possibility to get a "help.flex.apache.org" that wasn't
>>> run through the CMS or something to that effect, and they didn't like
the idea..
>>>
>>> By the way, when anybody updates the ASdocs, the CMS will take about
>>> 2 hours to process it. It also causes the buildbot process to crash
>>> ;S
>>>
>>> -Nick
>>>
>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>> <ap...@teotigraphix.com>wrote:
>>>
>>>>
>>>> Having the asdoc in the site folder, is this a good idea?
>>>>
>>>> The seems really wrong on a gut level to me but I don't have
>>>> another solution at the moment. I am sitting still waiting on a
>>>> broadband connection just to change my site info. This is also why
>>>> I only selectively check out whiteboard folders so I don't get
>>>> multiple copied branches of the 10000's of framework files and
>>>> tests.
>>>>
>>>> In reply to the Flash docs, IMHO me a re screwed and another reason
>>>> to keep running from Adobe. :) Since I have been working on a new
>>>> ASDOc tool/program I can see using the SWCs API to create the
>>>> entries and links in the docs but have links in them to the Adobe live
docs.
>>>>
>>>> This way you would get the api right in fornt of you all the way up
>>>> to Object but not the descriptions.
>>>>
>>>> Mike
>>>>
>>>> --
>>>> Michael Schmalle - Teoti Graphix, LLC http://www.teotigraphix.com
>>>> http://blog.teotigraphix.com
>>>>
>>>>
>>
>>
>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
Re: [DISCUSS] website asdocs
Posted by Carol Frampton <cf...@adobe.com>.
On 1/14/13 9 :02AM, "Michael Schmalle" <ap...@teotigraphix.com> wrote:
>Actually, I have to check into this but if adobe has publicly
>available SWCs that the new asdoc generator could load and parse the
>DITA with their documentation, adding Flash Player documentation is
>possible.
I'm pretty sure you don't have access to this. Even at Adobe, the Flex
group didn't build its own integrated docs because we didn't have all the
pieces.
Carol
Re: [DISCUSS] website asdocs
Posted by Michael Schmalle <ap...@teotigraphix.com>.
Actually, I have to check into this but if adobe has publicly
available SWCs that the new asdoc generator could load and parse the
DITA with their documentation, adding Flash Player documentation is
possible.
I'm speaking from ignorance here and I would have to investigate if
the playerglobal.swc somewhere has asdocs embedded.
Mike
Quoting Michael Schmalle <ap...@teotigraphix.com>:
>
> Quoting Harbs <ha...@gmail.com>:
>
>> Maybe, but there is the issue of the missing core classes (which I
>> mentioned in the other thread I started).
>
> I answered this, the only way to get core classes is by creating a
> new asdoc that parses and renders the API from SWCs which I know is
> possible, this way you get the API. I see no real option of getting
> the descriptions with those, only code generated links that point to
> the Adobe livedocs for each member etc which would be really akward.
>
>
>> I've also used the filter in the Adobe ASDocs based on Flash/AIR
>> version on occasion. For the classes where it matters, those
>> filters are useful.
>
> The current template for asdoc does not have all the JavaScript for
> filtering. At the moment this is impossible.
>
>
>> If we're picking the ASDocs apart, I'd add a padding to the Apache
>> Flex logo at the top right and probably make it a bit smaller?
>
> I just updated the image, I'm definitely not a web designer.
>
>
>> Harbs
>>
>> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>>
>>> I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has
>>> less clutter than the adobe ones and load faster.
>>>
>>>
>>>
>>> -----Original Message-----
>>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>>> Sent: Monday, January 14, 2013 7:55
>>> To: dev@flex.apache.org
>>> Subject: Re: [DISCUSS] website asdocs
>>>
>>> Personally, I like having the ASDocs on the website (and therefore, we have
>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>> different machines. I asked infra on IRC to see about the possibility to
>>> get a "help.flex.apache.org" that wasn't run through the CMS or something
>>> to that effect, and they didn't like the idea..
>>>
>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>> hours to process it. It also causes the buildbot process to crash ;S
>>>
>>> -Nick
>>>
>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>> <ap...@teotigraphix.com>wrote:
>>>
>>>>
>>>> Having the asdoc in the site folder, is this a good idea?
>>>>
>>>> The seems really wrong on a gut level to me but I don't have another
>>>> solution at the moment. I am sitting still waiting on a broadband
>>>> connection just to change my site info. This is also why I only
>>>> selectively
>>>> check out whiteboard folders so I don't get multiple copied
>>>> branches of the
>>>> 10000's of framework files and tests.
>>>>
>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>> tool/program I can see using the SWCs API to create the entries and links
>>>> in the docs but have links in them to the Adobe live docs.
>>>>
>>>> This way you would get the api right in fornt of you all the way up to
>>>> Object but not the descriptions.
>>>>
>>>> Mike
>>>>
>>>> --
>>>> Michael Schmalle - Teoti Graphix, LLC
>>>> http://www.teotigraphix.com
>>>> http://blog.teotigraphix.com
>>>>
>>>>
>>
>>
>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
Re: [DISCUSS] website asdocs
Posted by Nicholas Kwiatkowski <ni...@spoon.as>.
Michael,
Can you update the source branch for ASdocs? This will fix future versions
of the asdoc download we provide users as well...
-Nick
On Mon, Jan 14, 2013 at 8:58 AM, Michael Schmalle
<ap...@teotigraphix.com>wrote:
>
> Quoting Harbs <ha...@gmail.com>:
>
> Maybe, but there is the issue of the missing core classes (which I
>> mentioned in the other thread I started).
>>
>
> I answered this, the only way to get core classes is by creating a new
> asdoc that parses and renders the API from SWCs which I know is possible,
> this way you get the API. I see no real option of getting the descriptions
> with those, only code generated links that point to the Adobe livedocs for
> each member etc which would be really akward.
>
>
>
> I've also used the filter in the Adobe ASDocs based on Flash/AIR version
>> on occasion. For the classes where it matters, those filters are useful.
>>
>
> The current template for asdoc does not have all the JavaScript for
> filtering. At the moment this is impossible.
>
>
> If we're picking the ASDocs apart, I'd add a padding to the Apache Flex
>> logo at the top right and probably make it a bit smaller?
>>
>
> I just updated the image, I'm definitely not a web designer.
>
>
>
> Harbs
>>
>> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>>
>> I like the https://flex.apache.org/v2/**asdoc<https://flex.apache.org/v2/asdoc>ASDOCs atm. It has less clutter than the adobe ones and load faster.
>>>
>>>
>>>
>>> -----Original Message-----
>>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>>> Sent: Monday, January 14, 2013 7:55
>>> To: dev@flex.apache.org
>>> Subject: Re: [DISCUSS] website asdocs
>>>
>>> Personally, I like having the ASDocs on the website (and therefore, we
>>> have
>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>> different machines. I asked infra on IRC to see about the possibility to
>>> get a "help.flex.apache.org" that wasn't run through the CMS or
>>> something
>>> to that effect, and they didn't like the idea..
>>>
>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>> hours to process it. It also causes the buildbot process to crash ;S
>>>
>>> -Nick
>>>
>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>> <ap...@teotigraphix.com>**wrote:
>>>
>>>
>>>> Having the asdoc in the site folder, is this a good idea?
>>>>
>>>> The seems really wrong on a gut level to me but I don't have another
>>>> solution at the moment. I am sitting still waiting on a broadband
>>>> connection just to change my site info. This is also why I only
>>>> selectively
>>>> check out whiteboard folders so I don't get multiple copied branches of
>>>> the
>>>> 10000's of framework files and tests.
>>>>
>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>> tool/program I can see using the SWCs API to create the entries and
>>>> links
>>>> in the docs but have links in them to the Adobe live docs.
>>>>
>>>> This way you would get the api right in fornt of you all the way up to
>>>> Object but not the descriptions.
>>>>
>>>> Mike
>>>>
>>>> --
>>>> Michael Schmalle - Teoti Graphix, LLC
>>>> http://www.teotigraphix.com
>>>> http://blog.teotigraphix.com
>>>>
>>>>
>>>>
>>
>>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>
Re: [DISCUSS] website asdocs
Posted by Michael Schmalle <ap...@teotigraphix.com>.
Quoting Alex Harui <ah...@adobe.com>:
>
>
>
> On 1/14/13 6:18 AM, "Michael Schmalle" <ap...@teotigraphix.com> wrote:
>
>> On a side note;
>>
>> I cannot imagine how long it would take to update the CMS with the
>> FlashPlayer API in there as well.
>>
> We do not have a license to copy the Flash and other Adobe ASDocs to Apache.
> Someday, our ASDoc's should point to the Adobe ASLR for flash.*.* and other
> packages. It looks like most other project's JavaDoc jumps to Oracle for
> core Java classes.
In the beginning of this thread, this is what I proposed with the
ASDoc program I have written. We can parse the playerglobal.swc and
get the api. Render all the inherited members just like we do but the
links however we see fit will be links the Adobe's language reference.
I already have the documentor creating the inheritance hierarchy all
the way to Object;
See; http://www.teotigraphix.org/apache-flex-4.8/mx/core/UIComponent.html
Mike
Mike
> --
> Alex Harui
> Flex SDK Team
> Adobe Systems, Inc.
> http://blogs.adobe.com/aharui
>
>
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
Re: [DISCUSS] website asdocs
Posted by Alex Harui <ah...@adobe.com>.
On 1/14/13 6:18 AM, "Michael Schmalle" <ap...@teotigraphix.com> wrote:
> On a side note;
>
> I cannot imagine how long it would take to update the CMS with the
> FlashPlayer API in there as well.
>
We do not have a license to copy the Flash and other Adobe ASDocs to Apache.
Someday, our ASDoc's should point to the Adobe ASLR for flash.*.* and other
packages. It looks like most other project's JavaDoc jumps to Oracle for
core Java classes.
--
Alex Harui
Flex SDK Team
Adobe Systems, Inc.
http://blogs.adobe.com/aharui
Re: [DISCUSS] website asdocs
Posted by Nicholas Kwiatkowski <ni...@spoon.as>.
It didn't seem to be the length of the files, rather the number of files.
I have a a feeling that buildbot keeps an internal database of the files
it needs to touch for certain updates. I ended up niceing the process to
not break anything else on people.a.o
-Nick
On Mon, Jan 14, 2013 at 9:18 AM, Michael Schmalle
<ap...@teotigraphix.com>wrote:
> On a side note;
>
> I cannot imagine how long it would take to update the CMS with the
> FlashPlayer API in there as well.
>
> You have to understand the time would be exponential because not only are
> you adding all the new files for the Flash API but you are also adding a
> monumental amount of text into each Apache Flex asdoc page as well with the
> inherited information.
>
> But, I also understand this data would only be updated on each new release
> so I guess it really is a mute point in the end.
>
> Mike
>
>
>
> Quoting Harbs <ha...@gmail.com>:
>
> Neither am I, but it looks much better.
>>
>> On Jan 14, 2013, at 3:58 PM, Michael Schmalle wrote:
>>
>> I just updated the image, I'm definitely not a web designer.
>>>
>>>
>>> Harbs
>>>>
>>>> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>>>>
>>>> I like the https://flex.apache.org/v2/**asdoc<https://flex.apache.org/v2/asdoc>ASDOCs atm. It has less clutter than the adobe ones and load faster.
>>>>>
>>>>>
>>>>>
>>>>> -----Original Message-----
>>>>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>>>>> Sent: Monday, January 14, 2013 7:55
>>>>> To: dev@flex.apache.org
>>>>> Subject: Re: [DISCUSS] website asdocs
>>>>>
>>>>> Personally, I like having the ASDocs on the website (and therefore, we
>>>>> have
>>>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>>>> different machines. I asked infra on IRC to see about the possibility
>>>>> to
>>>>> get a "help.flex.apache.org" that wasn't run through the CMS or
>>>>> something
>>>>> to that effect, and they didn't like the idea..
>>>>>
>>>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>>>> hours to process it. It also causes the buildbot process to crash ;S
>>>>>
>>>>> -Nick
>>>>>
>>>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>>>> <ap...@teotigraphix.com>**wrote:
>>>>>
>>>>>
>>>>>> Having the asdoc in the site folder, is this a good idea?
>>>>>>
>>>>>> The seems really wrong on a gut level to me but I don't have another
>>>>>> solution at the moment. I am sitting still waiting on a broadband
>>>>>> connection just to change my site info. This is also why I only
>>>>>> selectively
>>>>>> check out whiteboard folders so I don't get multiple copied branches
>>>>>> of the
>>>>>> 10000's of framework files and tests.
>>>>>>
>>>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>>>> tool/program I can see using the SWCs API to create the entries and
>>>>>> links
>>>>>> in the docs but have links in them to the Adobe live docs.
>>>>>>
>>>>>> This way you would get the api right in fornt of you all the way up to
>>>>>> Object but not the descriptions.
>>>>>>
>>>>>> Mike
>>>>>>
>>>>>> --
>>>>>> Michael Schmalle - Teoti Graphix, LLC
>>>>>> http://www.teotigraphix.com
>>>>>> http://blog.teotigraphix.com
>>>>>>
>>>>>>
>>>>>>
>>>>
>>>>
>>>
>>
>>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>
Re: [DISCUSS] website asdocs
Posted by Michael Schmalle <ap...@teotigraphix.com>.
On a side note;
I cannot imagine how long it would take to update the CMS with the
FlashPlayer API in there as well.
You have to understand the time would be exponential because not only
are you adding all the new files for the Flash API but you are also
adding a monumental amount of text into each Apache Flex asdoc page as
well with the inherited information.
But, I also understand this data would only be updated on each new
release so I guess it really is a mute point in the end.
Mike
Quoting Harbs <ha...@gmail.com>:
> Neither am I, but it looks much better.
>
> On Jan 14, 2013, at 3:58 PM, Michael Schmalle wrote:
>
>> I just updated the image, I'm definitely not a web designer.
>>
>>
>>> Harbs
>>>
>>> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>>>
>>>> I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has
>>>> less clutter than the adobe ones and load faster.
>>>>
>>>>
>>>>
>>>> -----Original Message-----
>>>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>>>> Sent: Monday, January 14, 2013 7:55
>>>> To: dev@flex.apache.org
>>>> Subject: Re: [DISCUSS] website asdocs
>>>>
>>>> Personally, I like having the ASDocs on the website (and
>>>> therefore, we have
>>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>>> different machines. I asked infra on IRC to see about the possibility to
>>>> get a "help.flex.apache.org" that wasn't run through the CMS or something
>>>> to that effect, and they didn't like the idea..
>>>>
>>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>>> hours to process it. It also causes the buildbot process to crash ;S
>>>>
>>>> -Nick
>>>>
>>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>>> <ap...@teotigraphix.com>wrote:
>>>>
>>>>>
>>>>> Having the asdoc in the site folder, is this a good idea?
>>>>>
>>>>> The seems really wrong on a gut level to me but I don't have another
>>>>> solution at the moment. I am sitting still waiting on a broadband
>>>>> connection just to change my site info. This is also why I only
>>>>> selectively
>>>>> check out whiteboard folders so I don't get multiple copied
>>>>> branches of the
>>>>> 10000's of framework files and tests.
>>>>>
>>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>>> tool/program I can see using the SWCs API to create the entries and links
>>>>> in the docs but have links in them to the Adobe live docs.
>>>>>
>>>>> This way you would get the api right in fornt of you all the way up to
>>>>> Object but not the descriptions.
>>>>>
>>>>> Mike
>>>>>
>>>>> --
>>>>> Michael Schmalle - Teoti Graphix, LLC
>>>>> http://www.teotigraphix.com
>>>>> http://blog.teotigraphix.com
>>>>>
>>>>>
>>>
>>>
>>
>
>
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
Re: [DISCUSS] website asdocs
Posted by Harbs <ha...@gmail.com>.
Neither am I, but it looks much better.
On Jan 14, 2013, at 3:58 PM, Michael Schmalle wrote:
> I just updated the image, I'm definitely not a web designer.
>
>
>> Harbs
>>
>> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>>
>>> I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has less clutter than the adobe ones and load faster.
>>>
>>>
>>>
>>> -----Original Message-----
>>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>>> Sent: Monday, January 14, 2013 7:55
>>> To: dev@flex.apache.org
>>> Subject: Re: [DISCUSS] website asdocs
>>>
>>> Personally, I like having the ASDocs on the website (and therefore, we have
>>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>>> different machines. I asked infra on IRC to see about the possibility to
>>> get a "help.flex.apache.org" that wasn't run through the CMS or something
>>> to that effect, and they didn't like the idea..
>>>
>>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>>> hours to process it. It also causes the buildbot process to crash ;S
>>>
>>> -Nick
>>>
>>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>>> <ap...@teotigraphix.com>wrote:
>>>
>>>>
>>>> Having the asdoc in the site folder, is this a good idea?
>>>>
>>>> The seems really wrong on a gut level to me but I don't have another
>>>> solution at the moment. I am sitting still waiting on a broadband
>>>> connection just to change my site info. This is also why I only selectively
>>>> check out whiteboard folders so I don't get multiple copied branches of the
>>>> 10000's of framework files and tests.
>>>>
>>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>>> tool/program I can see using the SWCs API to create the entries and links
>>>> in the docs but have links in them to the Adobe live docs.
>>>>
>>>> This way you would get the api right in fornt of you all the way up to
>>>> Object but not the descriptions.
>>>>
>>>> Mike
>>>>
>>>> --
>>>> Michael Schmalle - Teoti Graphix, LLC
>>>> http://www.teotigraphix.com
>>>> http://blog.teotigraphix.com
>>>>
>>>>
>>
>>
>
Re: [DISCUSS] website asdocs
Posted by Michael Schmalle <ap...@teotigraphix.com>.
Quoting Harbs <ha...@gmail.com>:
> Maybe, but there is the issue of the missing core classes (which I
> mentioned in the other thread I started).
I answered this, the only way to get core classes is by creating a new
asdoc that parses and renders the API from SWCs which I know is
possible, this way you get the API. I see no real option of getting
the descriptions with those, only code generated links that point to
the Adobe livedocs for each member etc which would be really akward.
> I've also used the filter in the Adobe ASDocs based on Flash/AIR
> version on occasion. For the classes where it matters, those filters
> are useful.
The current template for asdoc does not have all the JavaScript for
filtering. At the moment this is impossible.
> If we're picking the ASDocs apart, I'd add a padding to the Apache
> Flex logo at the top right and probably make it a bit smaller?
I just updated the image, I'm definitely not a web designer.
> Harbs
>
> On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
>
>> I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has
>> less clutter than the adobe ones and load faster.
>>
>>
>>
>> -----Original Message-----
>> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
>> Sent: Monday, January 14, 2013 7:55
>> To: dev@flex.apache.org
>> Subject: Re: [DISCUSS] website asdocs
>>
>> Personally, I like having the ASDocs on the website (and therefore, we have
>> to have it in the SVN). Otherwise I have to download 8 copies for my 8
>> different machines. I asked infra on IRC to see about the possibility to
>> get a "help.flex.apache.org" that wasn't run through the CMS or something
>> to that effect, and they didn't like the idea..
>>
>> By the way, when anybody updates the ASdocs, the CMS will take about 2
>> hours to process it. It also causes the buildbot process to crash ;S
>>
>> -Nick
>>
>> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
>> <ap...@teotigraphix.com>wrote:
>>
>>>
>>> Having the asdoc in the site folder, is this a good idea?
>>>
>>> The seems really wrong on a gut level to me but I don't have another
>>> solution at the moment. I am sitting still waiting on a broadband
>>> connection just to change my site info. This is also why I only selectively
>>> check out whiteboard folders so I don't get multiple copied branches of the
>>> 10000's of framework files and tests.
>>>
>>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>>> keep running from Adobe. :) Since I have been working on a new ASDOc
>>> tool/program I can see using the SWCs API to create the entries and links
>>> in the docs but have links in them to the Adobe live docs.
>>>
>>> This way you would get the api right in fornt of you all the way up to
>>> Object but not the descriptions.
>>>
>>> Mike
>>>
>>> --
>>> Michael Schmalle - Teoti Graphix, LLC
>>> http://www.teotigraphix.com
>>> http://blog.teotigraphix.com
>>>
>>>
>
>
--
Michael Schmalle - Teoti Graphix, LLC
http://www.teotigraphix.com
http://blog.teotigraphix.com
Re: [DISCUSS] website asdocs
Posted by Harbs <ha...@gmail.com>.
Maybe, but there is the issue of the missing core classes (which I mentioned in the other thread I started).
I've also used the filter in the Adobe ASDocs based on Flash/AIR version on occasion. For the classes where it matters, those filters are useful.
If we're picking the ASDocs apart, I'd add a padding to the Apache Flex logo at the top right and probably make it a bit smaller…
Harbs
On Jan 14, 2013, at 3:03 PM, Kessler CTR Mark J wrote:
> I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has less clutter than the adobe ones and load faster.
>
>
>
> -----Original Message-----
> From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
> Sent: Monday, January 14, 2013 7:55
> To: dev@flex.apache.org
> Subject: Re: [DISCUSS] website asdocs
>
> Personally, I like having the ASDocs on the website (and therefore, we have
> to have it in the SVN). Otherwise I have to download 8 copies for my 8
> different machines. I asked infra on IRC to see about the possibility to
> get a "help.flex.apache.org" that wasn't run through the CMS or something
> to that effect, and they didn't like the idea..
>
> By the way, when anybody updates the ASdocs, the CMS will take about 2
> hours to process it. It also causes the buildbot process to crash ;S
>
> -Nick
>
> On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
> <ap...@teotigraphix.com>wrote:
>
>>
>> Having the asdoc in the site folder, is this a good idea?
>>
>> The seems really wrong on a gut level to me but I don't have another
>> solution at the moment. I am sitting still waiting on a broadband
>> connection just to change my site info. This is also why I only selectively
>> check out whiteboard folders so I don't get multiple copied branches of the
>> 10000's of framework files and tests.
>>
>> In reply to the Flash docs, IMHO me a re screwed and another reason to
>> keep running from Adobe. :) Since I have been working on a new ASDOc
>> tool/program I can see using the SWCs API to create the entries and links
>> in the docs but have links in them to the Adobe live docs.
>>
>> This way you would get the api right in fornt of you all the way up to
>> Object but not the descriptions.
>>
>> Mike
>>
>> --
>> Michael Schmalle - Teoti Graphix, LLC
>> http://www.teotigraphix.com
>> http://blog.teotigraphix.com
>>
>>
RE: [DISCUSS] website asdocs
Posted by Kessler CTR Mark J <ma...@usmc.mil>.
I like the https://flex.apache.org/v2/asdoc ASDOCs atm. It has less clutter than the adobe ones and load faster.
-----Original Message-----
From: Nicholas Kwiatkowski [mailto:nicholas@spoon.as]
Sent: Monday, January 14, 2013 7:55
To: dev@flex.apache.org
Subject: Re: [DISCUSS] website asdocs
Personally, I like having the ASDocs on the website (and therefore, we have
to have it in the SVN). Otherwise I have to download 8 copies for my 8
different machines. I asked infra on IRC to see about the possibility to
get a "help.flex.apache.org" that wasn't run through the CMS or something
to that effect, and they didn't like the idea..
By the way, when anybody updates the ASdocs, the CMS will take about 2
hours to process it. It also causes the buildbot process to crash ;S
-Nick
On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
<ap...@teotigraphix.com>wrote:
>
> Having the asdoc in the site folder, is this a good idea?
>
> The seems really wrong on a gut level to me but I don't have another
> solution at the moment. I am sitting still waiting on a broadband
> connection just to change my site info. This is also why I only selectively
> check out whiteboard folders so I don't get multiple copied branches of the
> 10000's of framework files and tests.
>
> In reply to the Flash docs, IMHO me a re screwed and another reason to
> keep running from Adobe. :) Since I have been working on a new ASDOc
> tool/program I can see using the SWCs API to create the entries and links
> in the docs but have links in them to the Adobe live docs.
>
> This way you would get the api right in fornt of you all the way up to
> Object but not the descriptions.
>
> Mike
>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>
Re: [DISCUSS] website asdocs
Posted by Nicholas Kwiatkowski <ni...@spoon.as>.
Personally, I like having the ASDocs on the website (and therefore, we have
to have it in the SVN). Otherwise I have to download 8 copies for my 8
different machines. I asked infra on IRC to see about the possibility to
get a "help.flex.apache.org" that wasn't run through the CMS or something
to that effect, and they didn't like the idea..
By the way, when anybody updates the ASdocs, the CMS will take about 2
hours to process it. It also causes the buildbot process to crash ;S
-Nick
On Mon, Jan 14, 2013 at 5:12 AM, Michael Schmalle
<ap...@teotigraphix.com>wrote:
>
> Having the asdoc in the site folder, is this a good idea?
>
> The seems really wrong on a gut level to me but I don't have another
> solution at the moment. I am sitting still waiting on a broadband
> connection just to change my site info. This is also why I only selectively
> check out whiteboard folders so I don't get multiple copied branches of the
> 10000's of framework files and tests.
>
> In reply to the Flash docs, IMHO me a re screwed and another reason to
> keep running from Adobe. :) Since I have been working on a new ASDOc
> tool/program I can see using the SWCs API to create the entries and links
> in the docs but have links in them to the Adobe live docs.
>
> This way you would get the api right in fornt of you all the way up to
> Object but not the descriptions.
>
> Mike
>
> --
> Michael Schmalle - Teoti Graphix, LLC
> http://www.teotigraphix.com
> http://blog.teotigraphix.com
>
>