I think Javadoc encourages coders to document their code better because it
is easy to make pretty HTML documentation.
We could do something similar by offering (at least informally) some
pretty-print stylesheets for pulling a:documentation, DocBook, or XHTML
annotations from RELAX NG schema.
The attached stylesheet is a meager beginning (revised from my last post on
this). I am happy to spend some more time on this, but I need critical
comments.
Mike
-----Original Message-----
From: James Clark [mailto:]
Sent: Wednesday, March 20, 2002 5:13 AM
To: John Cowan; Michael Fitzgerald
Cc: RELAX NG List
Subject: Re: [relax-ng] Annotations in the non-XML syntax
> I'd rather map the # comments into <!-- ... --> comments
I will try and do this, though it's not altogether straightforward. However,
I feel a little bit uneasy in that it will tend to encourage people to put
documentation in comments rather than annotations. I would like to find
some way for the non-XML syntax to make it as easy to put documentation in
annotations as in comments.
James
