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

Reply via email to