On 2002.03.14 19:11:13 -0500 Mac Rinehart wrote: > Ummm...well there's egg on my face. :) > > My goal is not to be critical of anyone here, or to any of the developers > who put the additional extra effort to generate documentation on top of > building an excellent product. If you've taken offense, my apologies. > Perhaps you can discount my failure to discover those items as the result > of > overwork, undersleep, and lack of familiarity with the JBoss site.
Sorry, I could have guessed that if I'd stepped back and thought, but got kind of pissed for a minute. And my > offer still stands to contribute to the documentation or to the process > of > developing it if that needs any work. Despite people yelling at you occasionally, all help is welcome. I don't know how much time and effort you want to put in, or how you would like to start. I think a fairly easy way to get started might be to try some "how do I do this simple task" things for jboss 3, we've discussed these but I don't think anyone has really started. For what its worth I think the best format for something like this would be a wiki, so that updating it doesn't need to involve cvs commits and rebuilding the website. Ideal would be a version controlled j2ee wiki running in jboss/jetty;-) Marc hasn't been thrilled yet with this idea (user howto wiki), but probably if someone made it happen his attitude might change. Thanks! david jencks > > Mac Rinehart, President > Sextant Technology Consulting, Inc > > Legal stuff: SEXTANT TECHNOLOGY CONSULTING is a trademark of Sextant > Technology Consulting, Inc. Any agreement to render services by Mac > Rinehart > and/or Sextant Technology Consulting, Inc. is contingent upon an > agreement > in writing and signed by all interested parties. > > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED]]On Behalf Of David > Jencks > Sent: Thursday, March 14, 2002 3:22 PM > To: [EMAIL PROTECTED] > Subject: Re: [JBoss-dev] RE: [JBoss-user] JBOSS 3.x FINAL > > > Ummm.... > In your previous post you wrote > "I've seen a lot of > complaints > in the forums regarding the same issues in the documentation for sale - > probably the only reason I haven't laid down my 10 spot yet. " > ... > "And if I were going to pay for > documentation, I don't want a print document that's going to be out of > date > in two weeks. " > > A couple of minutes of investigation would have revealed that the for pay > 2.4.4 documentation you are declining to buy so as to, perhaps, show your > support of JBoss and encourage the developers to write more > documentation, > is the exact same book that you are applauding at Amazon: > > http://www.jboss.org/doco.jsp > > "In order to support the development of JBoss and ensure that the > documentation remains up to date, we offer a PDF version of the JBoss > book > to be published by SAMS publishing. " > > Following the link also brings you to the Comperehensive Documentation > Subscription at the very top of the page, really hard to miss. > > david jencks > > On 2002.03.14 17:50:27 -0500 Mac Rinehart wrote: > > Another reason for different versions of the documentation for > different > > releases. The fact is that some people - particularly risk conscious > > corporate users - will continue to use 2.4 and not jump to 3.0 until > > another > > rev or two are out the door. > > > > Regarding Open source friendly tech writers - I think that could work, > > but > > it's got to take a little formal organization from the inside too. I > can > > see > > tech writers donating their writing services, but they probably would > > like > > to have some established procedures for how to access information, > style > > conventions and the like. I see that they sort of information is > > available > > for developers, I haven't seen it for tech writers (which doesn't mean > > much > > since I've only been following things actively for a couple of weeks). > > > > I would provide some tech writing services pro-bono, but establishing a > > procedure for getting the documentation in place is something that > takes > > a > > little organization. What's the status on JBoss Group's process for > > developing administration and user documentation? > > > > And BTW, this seems to be a good opportunity for plugging "JBoss > > Administration & Development", coming out on March 22 and doing > excellent > > on > > sales at Amazon already! Congrats. How does the book do in terms of > > covering > > version 3? > > > > > > Mac Rinehart, President > > Sextant Technology Consulting, Inc > > > > Legal stuff: SEXTANT TECHNOLOGY CONSULTING is a trademark of Sextant > > Technology Consulting, Inc. Any agreement to render services by Mac > > Rinehart > > and/or Sextant Technology Consulting, Inc. is contingent upon an > > agreement > > in writing and signed by all interested parties. > > > > > > -----Original Message----- > > From: David Ward [mailto:[EMAIL PROTECTED]] > > Sent: Thursday, March 14, 2002 1:42 PM > > To: Mac Rinehart > > Cc: Jboss-Development@Lists. Sourceforge. Net; Jboss-User@Lists. > > Sourceforge. Net > > Subject: Re: [JBoss-dev] RE: [JBoss-user] JBOSS 3.x FINAL > > > > > > It doesn't always lag - sometimes it's too eager! Example: I had a > > gripe that 2.4 documentation started disappering off the web site, > being > > replaced with 3.0 documentation when 3.0 was only alpha. I think that > > the 2.4 docs should stay available online - at least until 3.x goes > > final. > > > > Mac Rinehart wrote: > > > The free user documentation is only moderately useful, and > > > lags behind development on a number of issues. > > > > BEGIN:VCARD > > VERSION:2.1 > > N:Rinehart;Mac;;President > > FN:Mac Rinehart > > ORG:Sextant Technology Consulting > > TITLE:President > > TEL;WORK;VOICE:(503) 251-2855 > > ADR;WORK:;;7402 SE Yamhill Street;Portland;OR;97215;USA > > LABEL;WORK;ENCODING=QUOTED-PRINTABLE:7402 SE Yamhill > > Street=0D=0APortland, OR 97215=0D=0AUSA > > EMAIL;PREF;INTERNET:[EMAIL PROTECTED] > > REV:20011008T212138Z > > END:VCARD > > > > _______________________________________________ > Jboss-development mailing list > [EMAIL PROTECTED] > https://lists.sourceforge.net/lists/listinfo/jboss-development > > BEGIN:VCARD > VERSION:2.1 > N:Rinehart;Mac;;President > FN:Mac Rinehart > ORG:Sextant Technology Consulting > TITLE:President > TEL;WORK;VOICE:(503) 251-2855 > ADR;WORK:;;7402 SE Yamhill Street;Portland;OR;97215;USA > LABEL;WORK;ENCODING=QUOTED-PRINTABLE:7402 SE Yamhill > Street=0D=0APortland, OR 97215=0D=0AUSA > EMAIL;PREF;INTERNET:[EMAIL PROTECTED] > REV:20011008T212138Z > END:VCARD > _______________________________________________ Jboss-development mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/jboss-development