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!
>>> [EMAIL PROTECTED] 2004/11/10 11:49:26 AM >>> Hi chaps, 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: >> 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 expert >> + writer/editor) to redo all the documents; including the main >> website and wiki. Plus produce a high quality "getting going" guide >> (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]
