Re: Public/Private classification (was Re: javadocs navigation)

2005-10-15 Thread Stefano Mazzocchi
Reinhard Poetz wrote: Stefano Mazzocchi wrote: Reinhard Poetz wrote: Stefano Mazzocchi wrote: Daniel Fagerstrom wrote: [...] Daniel, let me repeat: I don't care about precision and elegance and completeness, I care about usability. I am thinking at flow users that want to use jav

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-15 Thread Stefano Mazzocchi
Vadim Gritsenko wrote: Stefano Mazzocchi wrote: Reinhard Poetz wrote: Reinhard, how many cocoon users have ever implemented org.apache.cocoon.xml.XMLPipe? All users who implemented at least one Transformer. public interface Transformer extends XMLPipe, SitemapModelComponent { } If yo

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-15 Thread Joerg Heinicke
On 15.10.2005 10:38, Reinhard Poetz wrote: I only doubt that the proposed way of how to find the classes and interfaces, that should become part of the public documentation, will lead to success. Do you guys really think that many people will start to evaluate ~670 classes and interfaces? And

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-15 Thread Reinhard Poetz
Stefano Mazzocchi wrote: Reinhard Poetz wrote: Stefano Mazzocchi wrote: Daniel Fagerstrom wrote: [...] Daniel, let me repeat: I don't care about precision and elegance and completeness, I care about usability. I am thinking at flow users that want to use java components to do their

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-14 Thread Vadim Gritsenko
Stefano Mazzocchi wrote: Reinhard Poetz wrote: Reinhard, how many cocoon users have ever implemented org.apache.cocoon.xml.XMLPipe? All users who implemented at least one Transformer. public interface Transformer extends XMLPipe, SitemapModelComponent { } If you are implementing transfo

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-14 Thread Stefano Mazzocchi
Reinhard Poetz wrote: Stefano Mazzocchi wrote: Daniel Fagerstrom wrote: [...] Daniel, let me repeat: I don't care about precision and elegance and completeness, I care about usability. I am thinking at flow users that want to use java components to do their stuff. They should *NOT* ca

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-14 Thread Vadim Gritsenko
Stefano Mazzocchi wrote: Daniel Fagerstrom wrote: Daniel Fagerstrom wrote: To illustrate what I meant I tried to follow the dependencies for the sitemap component interfaces. Cocoon API == So what is the Cocoon API? All interfaces used in cocoon-core-sitemap.xconf are part of th

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-14 Thread Daniel Fagerstrom
Stefano Mazzocchi wrote: ... Daniel, let me repeat: I don't care about precision and elegance and completeness, I care about usability. That is great Stefano, you find the the 673 classes and interfaces that need to be marked public or private, with usability in mind here: http://wiki.apac

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-13 Thread Reinhard Poetz
Stefano Mazzocchi wrote: Daniel Fagerstrom wrote: [...] Daniel, let me repeat: I don't care about precision and elegance and completeness, I care about usability. I am thinking at flow users that want to use java components to do their stuff. They should *NOT* care about org.apache.cocoo

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-13 Thread Stefano Mazzocchi
Daniel Fagerstrom wrote: Daniel Fagerstrom wrote: ... To illustrate what I meant I tried to follow the dependencies for the sitemap component interfaces. Cocoon API == ... So what is the Cocoon API? All interfaces used in cocoon-core-sitemap.xconf are part of the Cocoon API: Gen

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-13 Thread Daniel Fagerstrom
Daniel Fagerstrom wrote: ... To illustrate what I meant I tried to follow the dependencies for the sitemap component interfaces. Cocoon API == ... So what is the Cocoon API? All interfaces used in cocoon-core-sitemap.xconf are part of the Cocoon API: Generator, Transformer, Seria

Re: Public/Private classification

2005-10-13 Thread Stefano Mazzocchi
Vadim Gritsenko wrote: Reinhard Poetz wrote: --- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: IMO we need to find two set of interfaces/classes: the API of Cocoon, and the set of classes (components) that an application programmer need JavaDoc for. If it ain't public API you ain't need J

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-13 Thread Stefano Mazzocchi
Daniel Fagerstrom wrote: Upayavira wrote: So, I have created a wiki page: http://wiki.apache.org/cocoon/PublicAPIClasses Please go there and mark classes public/private as necessary. As it says at the top of that page, if you disagree with someone, change it to "dispute" or D for short. The

Re: Public/Private classification

2005-10-13 Thread Daniel Fagerstrom
Vadim Gritsenko wrote: Reinhard Poetz wrote: --- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: IMO we need to find two set of interfaces/classes: the API of Cocoon, and the set of classes (components) that an application programmer need JavaDoc for. If it ain't public API you ain't need

Re: Public/Private classification

2005-10-13 Thread Ralph Goers
Vadim Gritsenko wrote: Ralph Goers wrote: Vadim Gritsenko wrote: Reinhard Poetz wrote: --- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: IMO we need to find two set of interfaces/classes: the API of Cocoon, and the set of classes (components) that an application programmer need JavaDoc

Re: Public/Private classification

2005-10-13 Thread Vadim Gritsenko
Ralph Goers wrote: Vadim Gritsenko wrote: Reinhard Poetz wrote: --- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: IMO we need to find two set of interfaces/classes: the API of Cocoon, and the set of classes (components) that an application programmer need JavaDoc for. If it ain't public

Re: Public/Private classification

2005-10-13 Thread Ralph Goers
Vadim Gritsenko wrote: Reinhard Poetz wrote: --- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: IMO we need to find two set of interfaces/classes: the API of Cocoon, and the set of classes (components) that an application programmer need JavaDoc for. If it ain't public API you ain't need

Re: Public/Private classification

2005-10-13 Thread Vadim Gritsenko
Reinhard Poetz wrote: --- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: IMO we need to find two set of interfaces/classes: the API of Cocoon, and the set of classes (components) that an application programmer need JavaDoc for. If it ain't public API you ain't need Javadoc for it, period.

Re: Public/Private classification

2005-10-13 Thread Reinhard Poetz
--- Daniel Fagerstrom <[EMAIL PROTECTED]> schrieb: > Upayavira wrote: > > > So, I have created a wiki page: > > > > http://wiki.apache.org/cocoon/PublicAPIClasses > > > > Please go there and mark classes public/private as > necessary. As it > > says at the top of that page, if you disagree with

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-13 Thread Daniel Fagerstrom
Upayavira wrote: So, I have created a wiki page: http://wiki.apache.org/cocoon/PublicAPIClasses Please go there and mark classes public/private as necessary. As it says at the top of that page, if you disagree with someone, change it to "dispute" or D for short. Then it becomes an opportunit

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-12 Thread Vadim Gritsenko
Stefano Mazzocchi wrote: Upayavira wrote: So, I have created a wiki page: http://wiki.apache.org/cocoon/PublicAPIClasses I would also suggest to add all the other avalon components we ship by default too (I use the SourceResolver quite a bit and you need to pass this to the SourceUtil.getS

Re: Public/Private classification (was Re: javadocs navigation)

2005-10-12 Thread Stefano Mazzocchi
Upayavira wrote: So, I have created a wiki page: http://wiki.apache.org/cocoon/PublicAPIClasses Please go there and mark classes public/private as necessary. As it says at the top of that page, if you disagree with someone, change it to "dispute" or D for short. Then it becomes an opportunity

Public/Private classification (was Re: javadocs navigation)

2005-10-12 Thread Upayavira
So, I have created a wiki page: http://wiki.apache.org/cocoon/PublicAPIClasses Please go there and mark classes public/private as necessary. As it says at the top of that page, if you disagree with someone, change it to "dispute" or D for short. Then it becomes an opportunity for some healthy