I am sorry I do completly understand your last mail. See, you pointed me to the interesting page

http://cwiki.apache.org/WICKET/framework-documentation.html

(1) now, from the wicket website the reference link (was changed I think?) points to the other page, with the similar information. It might be a first start to figure out (you as experts) which of the two pages is the relevant one and link the right one.

(2) plus at the moment, there is still no link at all to the javadoc from the main website: I only found this one by accident.

this might be a second very helpful step.

(3) a third one would be best-practice guide on the main website listing "typical" issues like:

-- database connection / DAOs
-- Ajax
-- authentication
-- build management (Maven)
-- logging
...
...

and make references to the existing documentation, examples plus javadoc

(4) bring a conclusive list of examples; it seems, that there are several sets of examples distributed on the website, the wiki, the distribution... also confusing. at least a conclusive list with examples and where to find them would be very helpful



thank you



Alex



Igor Vaynberg wrote:
so how do you propose we consolidate it?

instead of javadoc have links to the wiki?

/**
 * see wicket.apache.org/wiki/authstrat
 */
public interface IAuthorizationStrategy {...}

that would really really suck.

-igor


On 8/9/07, Alexander Schatten <[EMAIL PROTECTED]> wrote:
Martijn Dashorst wrote:
http://cwiki.apache.org/WICKET/framework-documentation.html

sorry, I sent the last email to quick, was a Mistake; what I wanted to
point out is this:

http://cwiki.apache.org/WICKET/framework-documentation.html

this is your link, and it apparently has interesting information,
whereas when you search (as probably every newbie would) starting from
the wicket website, you go to the wiki and reference info, you come to:

http://cwiki.apache.org/WICKET/reference-library.html


now: this is what I meant before with very confusing documentation:
these two pages apparently cover similar topics, but are different in
details. then there is the confusing component reference plus the
javadoc which is also misleading sometimes (see the authentication stuff
with reference to non-existing methods).

don't you think this information base should be consolidated?



thank you very much



Alex


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]





---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to