forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ross Gardler <>
Subject Re: Fixing a Howto
Date Sun, 02 Oct 2005 22:25:46 GMT
Ferdinand Soethe wrote:
> 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 think the profiler does that - I've never played with it but David and 
Ron have done some work with it.

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

I guess it will be because you might use it to document other file types 
where namespaces are meaningless, but comments are available everywhere.

> 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.

Fair enough. Thanks.


View raw message