What would it take to get a wiki up and running? I think that is a very good idea. It is worth experimenting with, anyway. Something like that is incremental and if the right categories were created, people would have a place to quickly contribute without having to be a committer. I like the idea. Then some of that could probably be organized and funnelled into a formal doc, if we decide it would be better, but even if that never happened, what the heck, it would still be pretty good.
Jeff Tulley ([EMAIL PROTECTED]) (801)861-5322 Novell, Inc., the leading provider of Net business solutions http://www.novell.com >>> David Jencks <[EMAIL PROTECTED]> 03/14/02 18:12 PM >>> On 2002.03.14 19:11:13 -0500 Mac Rinehart wrote: 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 _______________________________________________ Jboss-development mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/jboss-development