cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From F Baube <fba...@welho.com>
Subject Re: Giving up! Cocoon too big, slow and confusing
Date Fri, 28 Jun 2002 08:49:10 GMT
thusly spake David Crossley:
>
> It amazes me that people have the time to compose email
> to the mailing list to tell us that they are too busy, 
> and then have the hide to tell us that documentation is poor.

Writing can be fast but submission + acceptance + check-in is not so 
straightforward.  how about a model more like some kind of production 
line ?

If someone volunteered to accept (and critique) (and organise) small 
 submissions of a page or two, then non-core people could take some 
notes whilst teach themselves things, and so ease that learning curve 
for the next person.  email: docs@cocoon.apache.org

These minidocs could be folded into the mainline docs, or turned into 
FAQ items, or How-To's, or whatever.  I think that this decision, i.e. 
where to file new minidocs, should be the decision of a core doc person.  
it is not up to _me_ to decide whether the thing I'm writing a FAQ or 
a How-To, because (a) I don't have the "big picture", and (b) the doc 
base already is sprawling and needs reorganisation, starting with the 
top-level menus... IMHO.

very simply, I could email this minidoc coördinator asking if (s)he 
has Doc X, for example "Directing servlet output into a Cocoon pipeline 
using Tomcat 4.x Filters".  If such a minidoc does not yet exist, then 
I whip it up; if it does already exist, the minidoc coördinator emails 
it to me for my additions / comments.

there could be a web page of existing minidoc titles.  call it "Pending 
Cocoon Documentation Fragments (WIP)".

this is where that PHP doc system (that someone provided a pointer to) 
seems to excel.  man pages that can be annotated by the community. (hey 
won't someone implement this in Cocoon ?  ;-)  then there should also be 
a person to periodically incorporate the annotations into the main text.  


hth,

fred

-- 
fbaube @ welho.com 
+ 358 41 536 8192 


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <cocoon-users-unsubscribe@xml.apache.org>
For additional commands, e-mail:   <cocoon-users-help@xml.apache.org>


Mime
View raw message