Re: I would like to offer myself to help with documentation

2001-06-21 Thread Jonathan Asbell
Sure Ted. Thanx. My perspective always comes from assuming that the reader doesnt know much. People get confused and sidetracked with jargon, and struts can be used by less experienced people if explained correctly. I mean, dont we want the user base to grow so it can be developed better and

Re: I would like to offer myself to help with documentation

2001-06-18 Thread Ted Husted
Absolutely everything is in the source download, under /doc Jonathan Asbell wrote: does someone have an example they can shoot to me of the xml and xsl used in documentation.

Re: I would like to offer myself to help with documentation

2001-06-18 Thread Craig R. McClanahan
On Mon, 18 Jun 2001, Jonathan Asbell wrote: does someone have an example they can shoot to me of the xml and xsl used in documentation. All of the docs in the Struts Documentation application (which is also the contents of the Struts web site) are generated this way. In addition, the

Re: I would like to offer myself to help with documentation

2001-06-17 Thread Jonathan Asbell
does someone have an example they can shoot to me of the xml and xsl used in documentation. - Original Message - From: Ted Husted [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Sunday, June 17, 2001 6:05 AM Subject: Re: I would like to offer myself to help with documentation Jonathan

I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
Hello all. It seems that there is a back log of documentation to do and I would like to offer to help with it as I am very good at explaining things. It also helps me understand the framework in a deeper way. However, because I am still relatively green with Struts (3 months) I will need to

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Ted Husted
Personally, I don't think that your questions would clutter up the list. If you don't understand it, then it's (very) likely that many others do not either. Moreover, the developer's list is intended for discussions about developing and packaging struts, and it * is * the appropriate place to

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
Really what ever is appropriate is fine. As long as you know in advance that I will be posting these questions through the process. I think the best place to start is where you feel documentation is needed most right now. I also think that the easier it is for first timers to understand Struts

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
Also, I think most of the explanations in available tutorials on the net are not clear. - Original Message - From: Ted Husted [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday, June 16, 2001 11:40 AM Subject: Re: I would like to offer myself to help with documentation Personally,

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Ted Husted
Jonathan wrote: I also think that the easier it is for first timers to understand Struts and how it works, the more likely you will have committed users and thus more feedback and thus better development. I have been meaning to try refactoring the installation page so that it starts with

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
Also, truthfully, you could provide this System.out version with the Struts Documentation war. That way you could read, use and watch the framework simultaneously - Original Message - From: Ted Husted [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday, June 16, 2001 12:38 PM Subject:

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Ted Husted
Depending on the length you should send them inline, or post them someplace for others to download. Or, if you want to send them to me, I'll post them on my Struts page. I'd be a little nervous about distributing MS Word documents myself, given the critters they can hide. The final drafts that

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
Ok. You tell me what you would like. I would like to send html for formatting purposes, but if you use stylesheets (which I hate but am willing to work with) I can send xml with a stylesheet - Original Message - From: Ted Husted [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday,

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Ted Husted
I often start with plain text since its easiest to retrofit with the XML tags later. Everything we use to build the Struts documentation is in the source download (\doc). Jonathan wrote: Ok. You tell me what you would like. I would like to send html for formatting purposes, but if you

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
ok. So I will send you my first piece in that format. Thanks Ted.(disconnecting) - Original Message - From: Ted Husted [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday, June 16, 2001 1:24 PM Subject: Re: I would like to offer myself to help with documentation I often start with

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Robert Leland
Jonathan wrote: thus more feedback and thus better development. I also think we you all need to package a war file in which System.outs can be generated in a clear way to demonstrate the steps Struts goes through from request to response. That helps users understand visually as well as with

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Martin Cooper
I've just started playing around with a free XML tool called XML Cooktop. It's pretty cool. You can load up the XML file in one tab of a window, the XSL in another, and switch to a third tab to see the result of applying the XSL to the XML. It works just fine with the Struts docs and stylesheets,

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Alan C. Yackel
Craig R. McClanahan wrote: On Sat, 16 Jun 2001, Jonathan wrote: Hello all. It seems that there is a back log of documentation to do and I would like to offer to help with it as I am very good at explaining things. It also helps me understand the framework in a deeper way. However,

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Alan C. Yackel
Craig R. McClanahan wrote: On Sat, 16 Jun 2001, Alan C. Yackel wrote: Another nice item would be more info on the XMLs. I've had to go through the DTD files before to figure out what some attributes do. A detailed description of all tags and attributes for the struts-config.xml

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Ted Husted
Broadening on the FAQ-o-MATIC idea, how about an extensible documentation system? Something like a Wiki, but with editing permissions. My favorite idea would be to take something like http://dmoz.org/ , complete with the heirarchies of permissions for editing, but be able to add pages at the

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
It would be nice if it was just simple. Stylesheets are not. Why dont we just use html - Original Message - From: Alan C. Yackel [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday, June 16, 2001 7:31 PM Subject: Re: I would like to offer myself to help with documentation Craig

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Jonathan
Try xml spy. Thats a real good one - Original Message - From: Martin Cooper [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday, June 16, 2001 5:17 PM Subject: Re: I would like to offer myself to help with documentation I've just started playing around with a free XML tool called

Re: I would like to offer myself to help with documentation

2001-06-16 Thread Martin Cooper
I did, and it is, but it's not free. XML Cooktop is. :-) -- Martin Cooper - Original Message - From: Jonathan [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Saturday, June 16, 2001 7:04 PM Subject: Re: I would like to offer myself to help with documentation Try xml spy. Thats a real