Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread Sean Schofield
Grrr... first I posted directly to James, then to the MAVEN dev list. -- Forwarded message -- From: Sean Schofield <[EMAIL PROTECTED]> Date: Feb 15, 2006 10:32 AM Subject: Tomahawk Documentation --> (Was ADF Faces) To: MyFaces Development Sorry. Meant to post this to

Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread Sean Schofield
Sorry. Meant to post this to the list. Sean -- Forwarded message -- From: Sean Schofield <[EMAIL PROTECTED]> Date: Feb 15, 2006 9:04 AM Subject: Re: ADF Faces To: James Holmes <[EMAIL PROTECTED]> James, Thanks for the offer. JIRA tickets sound good. The APT format sounds gre

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread Mike Kienenberger
On 2/15/06, Sean Schofield <[EMAIL PROTECTED]> wrote: > I have a few other ideas about the revised docs. I'm not sure syntax > and usage are that helpful. We now have a pretty good subsistute for > syntax in the form of the TLD docs. Maybe we could have a "See TLD > Documentation" under the synt

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread Sean Schofield
> I disagree with the removal of the usage section. The usage section > shows how to use the component in context which is not always obvious. > I don't see a problem with making it optional for trivial components, > however. Yes well some usage sections are better then others. I took a look ag

RE: Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread James Holmes
ebruary 15, 2006 10:33 AM To: MyFaces Development Subject: Tomahawk Documentation --> (Was ADF Faces) Sorry. Meant to post this to the list. Sean -- Forwarded message -- From: Sean Schofield <[EMAIL PROTECTED]> Date: Feb 15, 2006 9:04 AM Subject: Re: ADF Faces To: James

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-16 Thread Sean Schofield
On 2/16/06, James Holmes <[EMAIL PROTECTED]> wrote: > Thanks for the feedback Sean. From reading everyone else's feedback too, I'm > thinking it's best to just convert what already exists in xdoc format to APT > format initially. Once that's done, we can address what the desired content > of the pa

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-16 Thread Adam Winer
FWIW, one of the tools that will be coming from the ADF Faces side of things is a Maven 2 report that goes from our metadata to tagdocs that are a big improvement over the tlddoc generated docs. Tlddoc is pretty awful for JSF - every type is String, nothing is "request time", there's no list of fa

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-16 Thread Bill Dudney
That is great Adam, Is the source of the docs in the link below a standard tld file? if so that is great! TTFN, Bill Dudney MyFaces - myfaces.apache.org Wadi - incubator.apache.org/wadi On Feb 16, 2006, at 9:42 AM, Adam Winer wrote: FWIW, one of the tools that will be coming from the AD

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-16 Thread Adam Winer
It's not a TLD file, since TLDs simply don't have any of this information. Instead, it's a faces-config file. Our approach is that TLDs and JSP tags in general are secondary artifacts; faces-config is the primary artifact. -- Adam On 2/16/06, Bill Dudney <[EMAIL PROTECTED]> wrote: > That is

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-16 Thread Matthias Wessendorf
Hi Adam, that stuff looks really great! -Matthias On 2/16/06, Adam Winer <[EMAIL PROTECTED]> wrote: > It's not a TLD file, since TLDs simply don't have any > of this information. Instead, it's a faces-config file. > > Our approach is that TLDs and JSP tags in general > are secondary artifacts;

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-16 Thread Sean Schofield
I wonder if we could use annotations to help with the documentation generation? I'm not that famliar with annotations though so maybe I am way off here. Sean On 2/16/06, Matthias Wessendorf <[EMAIL PROTECTED]> wrote: > Hi Adam, > > that stuff looks really great! > > -Matthias > > On 2/16/06, Ada

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread Matthias Wessendorf
James has already started to open tickets http://issues.apache.org/jira/browse/MYFACES-1124 > > I guess for now I will open JIRA tickets with files attached. Let me know if > > you want me to submit the APT files a different way. Since he is Struts PMC and he knows and understands the ASF thing

Re: Tomahawk Documentation --> (Was ADF Faces)

2006-02-15 Thread Sean Schofield
We need to take a PMC vote on that. Existing ASF committers of course can be fast-tracked so I imagine that vote will come soon ;-). For now James has agreed to let us apply his patches for him. If you're going to apply a patch. Be sure to mark the JIRA issue as 'In progress' so we don't all ap