142 messages in org.apache.cocoon.devRe: javadocs navigation| From | Sent On | Attachments |
|---|---|---|
| 56 earlier messages | ||
| Daniel Fagerstrom | Oct 3, 2005 8:44 am | |
| Sylvain Wallez | Oct 3, 2005 8:53 am | |
| Carsten Ziegeler | Oct 3, 2005 8:57 am | |
| Sylvain Wallez | Oct 3, 2005 8:59 am | |
| Sylvain Wallez | Oct 3, 2005 9:00 am | |
| Stefano Mazzocchi | Oct 3, 2005 9:04 am | |
| Luca Morandini | Oct 3, 2005 9:11 am | |
| Andrew Savory | Oct 3, 2005 9:20 am | |
| Berin Loritsch | Oct 3, 2005 9:34 am | |
| Sylvain Wallez | Oct 3, 2005 10:07 am | |
| Ross Gardler | Oct 3, 2005 10:17 am | |
| Luca Morandini | Oct 3, 2005 10:30 am | |
| Nicola Ken Barozzi | Oct 3, 2005 10:44 am | |
| Antonio Gallardo | Oct 3, 2005 12:30 pm | |
| Sylvain Wallez | Oct 3, 2005 1:38 pm | |
| Steven Noels | Oct 4, 2005 1:08 am | |
| Daniel Fagerstrom | Oct 4, 2005 2:16 am | |
| Pier Fumagalli | Oct 4, 2005 2:31 am | |
| Bertrand Delacretaz | Oct 4, 2005 2:36 am | |
| Daniel Fagerstrom | Oct 4, 2005 3:01 am | |
| Andrew Savory | Oct 4, 2005 3:13 am | |
| Upayavira | Oct 4, 2005 3:17 am | |
| Bertrand Delacretaz | Oct 4, 2005 3:29 am | |
| Steven Noels | Oct 4, 2005 3:39 am | |
| Torsten Curdt | Oct 4, 2005 3:47 am | |
| hepabolu | Oct 4, 2005 4:00 am | |
| Joerg Heinicke | Oct 4, 2005 4:39 am | |
| Sylvain Wallez | Oct 4, 2005 4:57 am | |
| Daniel Fagerstrom | Oct 4, 2005 5:48 am | |
| Arje Cahn | Oct 4, 2005 5:55 am | |
| Stefano Mazzocchi | Oct 4, 2005 9:08 am | |
| Sylvain Wallez | Oct 4, 2005 9:24 am | |
| Carsten Ziegeler | Oct 4, 2005 12:43 pm | |
| Steven Noels | Oct 5, 2005 3:57 am | |
| Carsten Ziegeler | Oct 10, 2005 5:02 am | |
| Joerg Heinicke | Oct 11, 2005 2:03 pm | |
| Vadim Gritsenko | Oct 11, 2005 8:01 pm | |
| Stefano Mazzocchi | Oct 11, 2005 8:16 pm | |
| Vadim Gritsenko | Oct 11, 2005 8:35 pm | |
| Bertrand Delacretaz | Oct 11, 2005 11:20 pm | |
| Max Pfingsthorn | Oct 12, 2005 12:31 am | |
| Torsten Curdt | Oct 12, 2005 12:32 am | |
| Bertrand Delacretaz | Oct 12, 2005 12:58 am | |
| Sylvain Wallez | Oct 12, 2005 1:34 am | |
| Carsten Ziegeler | Oct 12, 2005 2:21 am | |
| Daniel Fagerstrom | Oct 12, 2005 4:52 am | |
| Stefano Mazzocchi | Oct 12, 2005 8:58 am | |
| Stefano Mazzocchi | Oct 12, 2005 9:01 am | |
| Upayavira | Oct 12, 2005 9:20 am | |
| Vadim Gritsenko | Oct 12, 2005 9:38 am | |
| Stefano Mazzocchi | Oct 12, 2005 9:47 am | |
| Niclas Hedhman | Oct 12, 2005 10:04 am | |
| Upayavira | Oct 12, 2005 11:57 am | |
| hepabolu | Oct 12, 2005 12:43 pm | |
| Stefano Mazzocchi | Oct 12, 2005 2:09 pm | |
| Stefano Mazzocchi | Oct 12, 2005 2:18 pm | |
| Stefano Mazzocchi | Oct 12, 2005 2:20 pm | |
| Sylvain Wallez | Oct 12, 2005 2:35 pm | |
| Vadim Gritsenko | Oct 12, 2005 2:47 pm | |
| Daniel Fagerstrom | Oct 13, 2005 2:41 am | |
| Reinhard Poetz | Oct 13, 2005 3:25 am | |
| Vadim Gritsenko | Oct 13, 2005 8:07 am | |
| Ralph Goers | Oct 13, 2005 9:14 am | |
| Vadim Gritsenko | Oct 13, 2005 9:22 am | |
| Ralph Goers | Oct 13, 2005 9:44 am | |
| Daniel Fagerstrom | Oct 13, 2005 9:56 am | |
| Stefano Mazzocchi | Oct 13, 2005 10:01 am | |
| Stefano Mazzocchi | Oct 13, 2005 10:05 am | |
| Daniel Fagerstrom | Oct 13, 2005 1:59 pm | |
| Joerg Heinicke | Oct 13, 2005 2:03 pm | |
| Joerg Heinicke | Oct 13, 2005 2:05 pm | |
| Stefano Mazzocchi | Oct 13, 2005 3:25 pm | |
| Reinhard Poetz | Oct 13, 2005 10:57 pm | |
| Daniel Fagerstrom | Oct 14, 2005 2:05 am | |
| Vadim Gritsenko | Oct 14, 2005 6:01 am | |
| Vadim Gritsenko | Oct 14, 2005 6:06 am | |
| Stefano Mazzocchi | Oct 14, 2005 11:34 am | |
| Vadim Gritsenko | Oct 14, 2005 11:45 am | |
| Reinhard Poetz | Oct 15, 2005 1:38 am | |
| Joerg Heinicke | Oct 15, 2005 1:40 am | |
| Joerg Heinicke | Oct 15, 2005 1:45 am | |
| Stefano Mazzocchi | Oct 15, 2005 8:53 am | |
| Stefano Mazzocchi | Oct 15, 2005 9:08 am | |
| Peter Hunsberger | Oct 21, 2005 10:12 pm | |
| Stefano Mazzocchi | Oct 23, 2005 10:39 am | |
| Peter Hunsberger | Oct 24, 2005 8:05 am | |
| Subject: | Re: javadocs navigation | |
|---|---|---|
| From: | Vadim Gritsenko (vad...@reverycodes.com) | |
| Date: | Oct 12, 2005 9:38:41 am | |
| List: | org.apache.cocoon.dev | |
Upayavira wrote:
Stefano Mazzocchi wrote:
Sylvain Wallez wrote:
Or more simpler, and we already talked about this, what about tagging the source files themselves to be able to produce javadocs of a restricted set of classes, i.e. those that are considered public API and that people can safely rely on.
There you go! +1
So how do we decide what is internal, what is external? The discussion is likely to be "fun".
Let's start small - let's mark as public, external classes only those where we have consensus, and leave "questionable" classes out, have a discussion on them later.
We could have a wiki page containing all classes, and mark the ones on that wiki page that we want to be public. Then a script could add the necessary javadoc markup.
Wiki page, where each java class can be marked as one of: public / private / dispute / not-marked-yet.
If that approach sounds okay, I'd happily volunteer to write the script to add the markup, assuming it is a simple enough markup.
Sounds good
Vadim