I think that documentation for corportate types will always be of the for-pay variety. It just takes too much time to produce that level of documentation, and it also isn't the sort of thing that developers tend to enjoy well enough to donate the required time. Now if anybody knows an open-source minded tech-writer geek, that might be a different story. Really, if you look at any major open-source project, this is true: If you want a well-written guide to how to configure Apache to do various things, you buy a book from O'Reilly. The documentation that's included with Apache is more reference material than anything. And it gets worse from there (look at Tomcat and Struts).
I'm sorry to hear that you've had trouble getting at the for-pay documentation: I know others have purchased it without difficulty. There was talk about putting a 'getting started' guide together for free, but I don't think anyone has picked that up. Also, my observation has been that as configuration file formats mature the dtds produced by the JBoss team get better and better as reference material; There are often succinct and informative comments for the less obvious or more important tags. -danch Trawick, James wrote: > What I'm really interested in is the more corporate questions (we're still > battling for JBoss over Weblogic, and clustering is a real sore point). How > does JBoss 3 clustering interact with web container clustering? If they're > completely separate (which I'm pretty sure is the case, as it was last time > I walked through the code), how can I put together a full clustered J2EE > stack with JBoss and (for example) Tomcat/Catalina? To what level does > JBoss provide high-availability? What are some failover scenarios? How > does one initiate a graceful failover for server maintenance? How > flexible/controllable is JBoss clustering in reality? > > There is nothing about these issues in the online docs, which I've been > monitoring pretty closely of late. The forums and the lists are pure and > simple information overload, and not always accurate. > > My point was that there really shouldn't be talk of releasing JBoss 3 for > prime time until there's real documentation for us corporate types, and the > docs for sale aren't real since they're not really available, at least not > to me for whatever reason. I'd be more than happy to help out in > documenting all this if somebody would point me in the right direction to > find the info. > > chris > > > -----Original Message----- > From: David Ward [mailto:[EMAIL PROTECTED]] > Sent: Thursday, March 14, 2002 1:56 PM > To: Trawick, James > Cc: 'marc fleury'; Jboss-Development@Lists. Sourceforge. Net; > Jboss-User@Lists. Sourceforge. Net > Subject: Re: [JBoss-user] JBOSS 3.x FINAL > > > A combination of these has served well enough for me: > > Online docs: http://www.jboss.org/online-manual/HTML/index.html > > Forums: http://main.jboss.org/ > > User List Archive: > http://www.mail-archive.com/jboss-user%40lists.sourceforge.net/ > > David > > -- > > Trawick, James wrote: > >>Will the final release actually include documentation? >> >>(btw, whoever you went with to sell your JBoss 3 docs should be shot. i >>went through their process several times, they said they had problems and >>would get back to me. they never did. just saying that unless JBoss 3 >> > has > >>some form of accessible documentation, i'm afraid that your vision will >>never come to pass.) >> >>chris >> >>-----Original Message----- >>From: marc fleury [mailto:[EMAIL PROTECTED]] >>Sent: Thursday, March 14, 2002 9:50 AM >>To: Jboss-Development@Lists. Sourceforge. Net >>Cc: Jboss-User@Lists. Sourceforge. Net >>Subject: [JBoss-user] JBOSS 3.x FINAL >> >> >>jboss one is end of march, and we will shoot for mid april for the final >>release. this gives us 4 weeks >> >>gentlemen put your final touches, >> >>4-3-2... >> >>marcf >> >> >>_______________________________________________ >>JBoss-user mailing list >>[EMAIL PROTECTED] >>https://lists.sourceforge.net/lists/listinfo/jboss-user >> >>_______________________________________________ >>JBoss-user mailing list >>[EMAIL PROTECTED] >>https://lists.sourceforge.net/lists/listinfo/jboss-user >> > > > _______________________________________________ > JBoss-user mailing list > [EMAIL PROTECTED] > https://lists.sourceforge.net/lists/listinfo/jboss-user > _______________________________________________ JBoss-user mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/jboss-user
