Hi Mike,

Thanks for those docs!

On Fri, Aug 7, 2009 at 10:13 AM, Mike Müller<[email protected]> wrote:

> ...[1] http://sling.apache.org/site/dispatching-requests.html...

Looks good to me.

> [2] http://sling.apache.org/site/servlets.html

Added the "automated tests" section. In general, I think it's good for
reference docs to link to automated tests, as those (hopefully)
represent the Ultimate Truth in how things run, i.e. they cannot be
out of sync with the current code.

I *think* confluence has a plugin to grab code directly from svn and
include it in pages, if that's the case we might want to use that to
include "live" test code snippets in the docs? Let me know if you want
to pursue this - for now linking to test classes is good already.

> [3] 
> http://sling.apache.org/site/managing-users-and-groups-jackrabbitusermanager.html

Read it but I don't really know how things work, so cannot comment.
Do we have tests for that code, that we could refer to?

> At [3] the code is formatted a little bit strange, can someone have a look at 
> the
> CSS (div.code and class java:nocontrols:nogutter).

Note that, until we fix this, using {noformat} instead of {code} works
(see http://sling.apache.org/site/discover-sling-in-15-minutes.html).

-Bertrand

Reply via email to