forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ferdinand Soethe <>
Subject Re: Fixing a Howto
Date Sun, 02 Oct 2005 21:37:37 GMT

Ross Gardler wrote:

> I'd like to consider using the recent Google SoC project over in Cocoon
> that created auto documenting sitemaps. If I understand correctly it 
> does what you wanted to do some time ago, in that we can annotate the 
> sitemaps with Javadoc like comments for generating documentation.

> Do you have the time/inclination to take a look at it? [2] and [3]

Hi Ross,

thanks for that pointer.

It's not actually what I was looking for (Which was a mechanism of
logging the way of requests through a sitemap as a way of debugging
them; would have been very useful for my current html-problem).

I looked at it anyway and briefly wondered why the documentation
happens in SGML-comments rather then xml-elements with their own

Apart from that I see not much progress from using DOCTOR (except that
we should of course use the documentation structure that this
requires) because we don't have much documentation in our sitemaps
right now.

And once that documentation is added, that would be easy enough to
read w/o having to extract it into html-documents. So I'd consider
that stuff nice to have but nothing to put much effort into.

Ferdinand Soethe

View raw message