[EMAIL PROTECTED] wrote:
>(Natural, I guess.....who's gonna
> sit and write good documentation anyway.  This is almost as hard as writing
> good software!)

It my experience it's harder (and doesn't pay as well) -:0)

Projects are always desperate for better documentation, and we have had
some great pieces of ours sent in by people who were reading it, and
wanted to improve it as they went along. That's where the Walking Tour
of the example application came from. I wrote it to explain the example
to myself, and then shared it with the group. 

Contributing documentation to a project is no different than
contributing code. 

http://jakarta.apache.org/site/getinvolved.html

The only caveat is that it *is* no different than contributing code, and
so it should be in the same format as the rest of the documentation,
ready to paste or otherwise patch.

-Ted.


[EMAIL PROTECTED] wrote:
> 
> Good luck Sanjay!  Even the documentation to Struts itself does not tell
> you how to use it. Tells you how to build parts, but not really how to get
> them together.  It's typical developer documentation.  Open source software
> is wonderful, but developers do not seem to be as enthusastic about
> documenting as they are about developing. (Natural, I guess.....who's gonna
> sit and write good documentation anyway.  This is almost as hard as writing
> good software!)
> 
> We need to start the Open Source Documentation Initiative and save this
> glorious revolution from its one greatest flaw.
> 
> - Cody
> 
> Sanjay Choudhary <[EMAIL PROTECTED]> on 02/06/2002 04:11:23 PM
> 
> Please respond to Struts Users Mailing List
>       <[EMAIL PROTECTED]>
> To:   Struts Users Mailing List <[EMAIL PROTECTED]>
> cc:
> Subject:  How to go about??
> 
> Hi Friends,
> 
> I am very new to Struts. All I have done is worked out
> couple of examples from web to understand the
> Architecture. We are in a process of designing a
> Product and plan to use Struts Framework with EJB's.
> 
> In my team
> 1. No one has any knowledge about Struts but they are
> very good with Java and J2EE.
> 
> 2. Except for a HTML designer, most of the programmers
> are involved with backend programming. They have done
> very little HTML work. I was wondering if we will be
> able to create JSP's using Struts HTML tags and other
> tag libraries if a form is defined using pure HTML.
> 
> 3. What is the best way to go about to learn Struts to
> use in practical life and how much time it takes?
> 
> 4. What strategies did you guys adopt to move to
> Struts?
> 
> 5. All pointers to valuable resources and design
> stratergies will be appreciated.
> 
> Thanks you ,
> Sanjay
> 
> __________________________________________________
> Do You Yahoo!?
> Send FREE Valentine eCards with Yahoo! Greetings!
> http://greetings.yahoo.com
> 
> --
> To unsubscribe, e-mail:   <
> mailto:[EMAIL PROTECTED]>
> For additional commands, e-mail: <
> mailto:[EMAIL PROTECTED]>
> 
> ----------------------------------------------------------------
> The information transmitted is intended only for the person or entity to
> which it is addressed and may contain confidential and/or privileged
> material.  Any review, retransmission, dissemination or other use of, or
> taking of any action in reliance upon, this information by persons or
> entities other than the intended recipient is prohibited.   If you received
> this in error, please contact the sender and delete the material from any
> computer.
> 
> --
> To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to