Bob Harner wrote:
As for comments within files, it might be worthwhile to more carefully consider how this is structured, rather than just putting plain text inside of comment tags. It would be nice to have the internal documentation in these files be extractable (someday) by a program, in the same way that javadoc documentation is easily extractable from java source code.
Very good point. > See
http://www.codeproject.com/soap/xsltdocumentor.asp an example of such a program for XSLT files in particular. Does anyone else have any suggestions in this area? We will need a syntax for documenting xslt and xmap files especially.
Unfortunately I can't share any experience. I wouldn't mind adding this to our coding guidelines. Would it be much work to implement an Ant task which generates the documentation? -- Andreas --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
