atom feed142 messages in org.apache.cocoon.devRe: Public/Private classification
FromSent OnAttachments
72 earlier messages
Daniel FagerstromOct 4, 2005 2:16 am 
Pier FumagalliOct 4, 2005 2:31 am 
Bertrand DelacretazOct 4, 2005 2:36 am 
Daniel FagerstromOct 4, 2005 3:01 am 
Andrew SavoryOct 4, 2005 3:13 am 
UpayaviraOct 4, 2005 3:17 am 
Bertrand DelacretazOct 4, 2005 3:29 am 
Steven NoelsOct 4, 2005 3:39 am 
Torsten CurdtOct 4, 2005 3:47 am 
hepaboluOct 4, 2005 4:00 am 
Joerg HeinickeOct 4, 2005 4:39 am 
Sylvain WallezOct 4, 2005 4:57 am 
Daniel FagerstromOct 4, 2005 5:48 am 
Arje CahnOct 4, 2005 5:55 am 
Stefano MazzocchiOct 4, 2005 9:08 am 
Sylvain WallezOct 4, 2005 9:24 am 
Carsten ZiegelerOct 4, 2005 12:43 pm 
Steven NoelsOct 5, 2005 3:57 am 
Carsten ZiegelerOct 10, 2005 5:02 am 
Joerg HeinickeOct 11, 2005 2:03 pm 
Vadim GritsenkoOct 11, 2005 8:01 pm 
Stefano MazzocchiOct 11, 2005 8:16 pm 
Vadim GritsenkoOct 11, 2005 8:35 pm 
Bertrand DelacretazOct 11, 2005 11:20 pm 
Max PfingsthornOct 12, 2005 12:31 am 
Torsten CurdtOct 12, 2005 12:32 am 
Bertrand DelacretazOct 12, 2005 12:58 am 
Sylvain WallezOct 12, 2005 1:34 am 
Carsten ZiegelerOct 12, 2005 2:21 am 
Daniel FagerstromOct 12, 2005 4:52 am 
Stefano MazzocchiOct 12, 2005 8:58 am 
Stefano MazzocchiOct 12, 2005 9:01 am 
UpayaviraOct 12, 2005 9:20 am 
Vadim GritsenkoOct 12, 2005 9:38 am 
Stefano MazzocchiOct 12, 2005 9:47 am 
Niclas HedhmanOct 12, 2005 10:04 am 
UpayaviraOct 12, 2005 11:57 am 
hepaboluOct 12, 2005 12:43 pm 
Stefano MazzocchiOct 12, 2005 2:09 pm 
Stefano MazzocchiOct 12, 2005 2:18 pm 
Stefano MazzocchiOct 12, 2005 2:20 pm 
Sylvain WallezOct 12, 2005 2:35 pm 
Vadim GritsenkoOct 12, 2005 2:47 pm 
Daniel FagerstromOct 13, 2005 2:41 am 
Reinhard PoetzOct 13, 2005 3:25 am 
Vadim GritsenkoOct 13, 2005 8:07 am 
Ralph GoersOct 13, 2005 9:14 am 
Vadim GritsenkoOct 13, 2005 9:22 am 
Ralph GoersOct 13, 2005 9:44 am 
Daniel FagerstromOct 13, 2005 9:56 am 
Stefano MazzocchiOct 13, 2005 10:01 am 
Stefano MazzocchiOct 13, 2005 10:05 am 
Daniel FagerstromOct 13, 2005 1:59 pm 
Joerg HeinickeOct 13, 2005 2:03 pm 
Joerg HeinickeOct 13, 2005 2:05 pm 
Stefano MazzocchiOct 13, 2005 3:25 pm 
Reinhard PoetzOct 13, 2005 10:57 pm 
Daniel FagerstromOct 14, 2005 2:05 am 
Vadim GritsenkoOct 14, 2005 6:01 am 
Vadim GritsenkoOct 14, 2005 6:06 am 
Stefano MazzocchiOct 14, 2005 11:34 am 
Vadim GritsenkoOct 14, 2005 11:45 am 
Reinhard PoetzOct 15, 2005 1:38 am 
Joerg HeinickeOct 15, 2005 1:40 am 
Joerg HeinickeOct 15, 2005 1:45 am 
Stefano MazzocchiOct 15, 2005 8:53 am 
Stefano MazzocchiOct 15, 2005 9:08 am 
Peter HunsbergerOct 21, 2005 10:12 pm 
Stefano MazzocchiOct 23, 2005 10:39 am 
Peter HunsbergerOct 24, 2005 8:05 am 
Subject:Re: Public/Private classification
From:Daniel Fagerstrom (dani@nada.kth.se)
Date:Oct 13, 2005 9:56:32 am
List:org.apache.cocoon.dev

Vadim Gritsenko wrote:

Reinhard Poetz wrote:

--- Daniel Fagerstrom <dani@nada.kth.se> 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.

WDYT?

I agree completly with you!

I don't. You both miss the point, which is: It is JFDI effort which should bring in results quickly, namely set of public classes which are agreed by *whole community* to be public, which means *everybody* agrees that these classes and interfaces will be supported and carefully evolved.

Vadim, I don't think you got my point. Having an opinion about 673 classes seemed to be a lot of work. And asking the *whole community* for having an opinion about all of them seem to be a rather time consuming way. To me it seem better to have some discussion about how to find an efficient way to choose.

Furthermore we cannot just have any ad hoc selection of classes/interfaces as public API, all classes/interfaces that is refered to from the public API must be part of it. Is there any convenient way to get all refered interfaces from a given set of intefaces?

If you don't agree with public denominator on one of the classes, just mark it D (we are looking for consensus here!) and have a healthy lengthy discussion about it,

Concensus about exactly what? To me it was unclear what the exact purpose of the activity was, and I wrote my mail because I wanted to get a better idea about that. And if you are prepared to have helthy lengthy discussions about the specific classes I can't understand why you don't even bother about commenting my opinions about how to classify.

but please don't block this effort to produce *good-enough* results quickly in the sake of ivory tower of perfect API separation and bundles and what not...

That is BS, I tried to find a practical way of solving the problem of finding a public API with a reasonable amount of effort. I'm not talking about any perfectness here. And for the bundle and separation step aspect, I think I made it pretty clear that it was a separate and later step.

So, are you on board?

Ity should be rather obvious from my previous post in this thread and from earlier posts that I want us to find out the public API for Cocoon. But to get any further in this discussion I propose that you re-read my last post and give some constructive critic instead of just dissmissing it.

/Daniel