Luc Saint-Elie wrote:
>
> I can perfectly say to a customer "this nice application is based on a
> community development effort", but I can't say "well, in order to use this
> app, you just need to hack around the properties file according to the
> documentation that is missing and if every thing is screwed, just try the
> opposite way and pray" :-)))
>
> And there are a huge lot of black holes for instance. For example, I still
> don't understand why although I've set up the new InstantDB JDBC driver in
> Turbine Properties, when I try 1.2b1 I get a class not found for the old
> one....
>
> The various path for the various settings are very cryptic especially under
> NT and I strongly believe that the key to opensource application success is
> to take NT in account. No OS war here, I really don't give a s...t about
> the fact that NT is or is not a good OS. The fact is that inside the
> companies, for departmental server there is (for instance) a lot of NT.
>
Jetspeed runs OK under NT since it's my main development platform. What options
do you find cryptic ?
> What I wanted to say is that the combination of the "bazaar" Open Source
> and a "normal" documentation is possible, Tomcat user guide is becoming a
> real impressive work and on the other hand, Struts distribution may be seen
> as a standard for further releases.
>
> I do know that a documentation will not be written by magic, and I'm one
> among I suppose a lot of others, that would be very pleased to help....
>
There's curently a need for 2 kinds of user documentation :
- installation docs
- user operation
The first one is the most important right now.
The issue we have with installation is that I find (and I think Kevin too) the
installation setup clearly explained by the comments in the properties file. This
is evidently not the case for a lot of people on this mailing-list
So that we can do is that volunteer(s) on this list create a basic installation
guide to their target web server/servlet engine/platform once they have successfully
setup Jetspeed 1.2b1 and post their documentation on the Jetspeed FAQ.
If some question arise about a specific property use or syntax, ask the question
on the list with an [INSTALL/FAQ] marker in the subject and we (developers) will
answer it so that you can put the question and response in the FAQ. Hopefully, this
will clear up a lot of confusion and the required elements to run Jetspeed and it
is easier to manage than trying to help people out of their install problems, which
seem most often related to incorrect servlet engine setup.
Some volunteers ?
--
Rapha�l Luta - [EMAIL PROTECTED]
--
--------------------------------------------------------------
Please read the FAQ! <http://java.apache.org/faq/>
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Archives and Other: <http://java.apache.org/main/mail.html>
Problems?: [EMAIL PROTECTED]
