Re: Javadocs: need basic package information

2003-01-04 Thread David Crossley
Stefano Mazzocchi wrote: > Sylvain Wallez wrote: > > Bernhard Huber wrote: > i think writing a single packages.xml is better than maintaing 84 > package.html files. > >>> > >>> IMO, a centralized XML file may not be better as far as keeping it up > >>> to date is concerned : > >>> - peo

Re: Javadocs: need basic package information

2003-01-04 Thread David Crossley
Sylvain Wallez wrote: > David Crossley wrote: > > >There is one important reason for having separate > >package.xml next to the component source code ... when > >Cocoon is able to add new components (blocks?) automatically. > > Can you elaborate more on this ? As far as I understand them (they're

Re: Javadocs: need basic package information

2003-01-04 Thread Stefano Mazzocchi
Sylvain Wallez wrote: Bernhard Huber wrote: hi, i think writing a single packages.xml is better than maintaing 84 package.html files. IMO, a centralized XML file may not be better as far as keeping it up to date is concerned : - people may often forget to update a central file far away fr

Re: Javadocs: need basic package information

2003-01-03 Thread Sylvain Wallez
David Crossley wrote: Sylvain Wallez wrote: Bernhard Huber wrote: i think writing a single packages.xml is better than maintaing 84 package.html files. IMO, a centralized XML file may not be better as far as keeping it up to date is concerned : - people may often forget to upda

Re: Javadocs: need basic package information

2003-01-02 Thread David Crossley
Sylvain Wallez wrote: >Bernhard Huber wrote: >> i think writing a single packages.xml is better than maintaing >> 84 package.html files. > > IMO, a centralized XML file may not be better as far as keeping > it up to date is concerned : > - people may often forget to update a central file far away

Re: Javadocs: need basic package information

2003-01-01 Thread Sylvain Wallez
Bernhard Huber wrote: hi, i think writing a single packages.xml is better than maintaing 84 package.html files. IMO, a centralized XML file may not be better as far as keeping it up to date is concerned : - people may often forget to update a central file far away from the source files. -

Re: Javadocs: need basic package information

2002-12-25 Thread Joerg Pietschmann
On Wednesday 25 December 2002 10:05, you wrote: > somehow it comes down to question who will most likely write the > package docs. > Programmers? than package.html is better > NonProgrammers, or NotOriginalProgrammers than package.xml is better. You can have both, provided you sit down and write a

Re: Javadocs: need basic package information

2002-12-25 Thread Bernhard Huber
hi, * add a packages.dtd ala faq.dtd Yes, it is good to constrain the content. How much constraint is suitable? Perhaps faq.dtd is too loose, e.g. it allows ... On the other hand, perhaps we should not try to pre-determine the content model. Hmm, i think we should reuse as much document-v

Re: Javadocs: need basic package information

2002-12-25 Thread Bernhard Huber
hi, i think writing a single packages.xml is better than maintaing 84 package.html files. IMO, a centralized XML file may not be better as far as keeping it up to date is concerned : - people may often forget to update a central file far away from the source files. - will people really go insi

Re: Javadocs: need basic package information

2002-12-24 Thread Sylvain Wallez
Bernhard Huber wrote: hi, i have read the thread http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=102056702426129 again. i'd like to start it, i think writing a single packages.xml is better than maintaing 84 package.html files. IMO, a centralized XML file may not be better as far as keepin

Re: Javadocs: need basic package information

2002-12-23 Thread David Crossley
Bernhard Huber wrote: > hi, > i have read the thread > http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=102056702426129 > again. > > i'd like to start it, > > i think writing a single packages.xml is better than > maintaining 84 package.html files. Great. This is a good approach. > * add a pac

Re: Javadocs: need basic package information

2002-12-23 Thread Bernhard Huber
hi, i have read the thread http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=102056702426129 again. i'd like to start it, i think writing a single packages.xml is better than maintaing 84 package.html files. * add a packages.dtd ala faq.dtd * write a single packages.xml conforming to packages.d

new plan/todo-doc.xml (Was: Javadocs: need basic package information)

2002-05-07 Thread David Crossley
Diana Shannon wrote: > David Crossley wrote: > > > > A lot of helpful suggestions! > > > These are other tasks to be added to the "To Do" list for the > > general documentation project ... > > Clearly a to-do list is the first of *several* management/planning files > the doc effort needs. Wher

Re: Javadocs: need basic package information

2002-05-05 Thread Diana Shannon
On May 4, 2002, David Crossley wrote: A lot of helpful suggestions! > These are other tasks to be added to the "To Do" list for the > general documentation project ... Clearly a to-do list is the first of *several* management/planning files the doc effort needs. Where should it reside? I'm don

Javadocs: need basic package information

2002-05-04 Thread David Crossley
I tried using the Javadocs recently to figure out how a certain component works. I find that Javadocs are a dissapointment in general. There is one significant thing that is lacking The front page of Javadocs is the package index. There are 84 packages in Cocoon and only 6 of them have the b