I agree with the point you make, so lets start the ball rolling. Is there anybody out there that would like to document editor-in-charge?
regards
Andrew
On 10 Nov 2004, at 10:30, Derek Hohls wrote:
Andrew
There have been attempts before to get the documentation
more organised/comprehensive/up-to-date etc etc. People
tend to get defensive - understandably so - if they feel this
is directed "against" them. Clearly, we all do "what we can"
and no one is saying that no documentation *at all* is better
than what we have (!). Nonetheless, its my belief that a firm
hand needs to be applied across the board... taking a big
picture point-of-view to rationalise, rewrite, discard etc. to
move to a higher standard. Not all of us are capable of this -
I am sure that we'd all rather be doing system development
anyway - but we could certainly comment and add our 2c on
any drafts (bearing in mind that the "editors decision is final").
I am hopeful that a suitable person to take on this role exists
in the community!
Hi chaps,[EMAIL PROTECTED] 2004/11/10 11:49:26 AM >>>
I think it would be a good idea then for a comprehensive documentation
standard to be draw-up, against which the rest of the community to
produce cohesive documentation against.
regards
Andrew
On 10 Nov 2004, at 09:33, David Crossley wrote:
Derek Hohls wrote:expert
Ralph
Yup. I am not envious of any other open source package
ito community support and the intrinsic capability of the system
but I if had the odd, spare $10k or even $100k lying around
the first thing I would do is offer to hire some people (tech
guide+ writer/editor) to redo all the documents; including the main
website and wiki. Plus produce a high quality "getting going"
---------------------------------------------------------------------(such as the one that projects like Hibernate has.)
I can dream, right?
Derek
PS Yes, in theory, the above could be done by the community,
but in practice some old-fashioned, top-down, focussed effort is
actually what it takes to get something like this together.
Or some new-fashioned concept, like Bertrand just suggested.
It must be a community effort. It would be almost
impossible for a small group of "experts" to
document Cocoon. I doubt that anyone could say that
they knew every aspect in detail. So we need to mobilise
our current community.
--
David Crossley
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
--
This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.
MailScanner thanks transtec Computers for their support.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
<<inline: beya-email.gif>>
�+The home of urban music
+ http://www.beyarecords.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
