[Mono-list] Re: [Mono-docs-list] WebControls Documentation

[Adam Treat]

> The only issue we have at hand is that we do need some tools to create
> the documentation outside the main sources (the rationale can be found
> in http://www.go-mono.com/classlib-doc.html).
>
> Adam and John have done some of the work needed, but I am not sure we
> are ready yet to have the documents written.  We still need the tools to
> be completed.
>
> Miguel.

I hate the idea of this holding up writing external documentation.  While it 
is true that the tools are not complete, if we can just come up with a 
standard DTD for the external documentation, then maybe we can get started 
actually writing the docs.  Below is the sample I was using for external 
documentation.  Another issue to think about is where to put the external 
docs.  

<?xml version="1.0"?>
<!DOCTYPE MonoDocExtern>
<assembly name="">
  <class name="">
    <member name="">
      <summary>blah</summary>
      <remarks>blah</remarks>
      <foo>bar</foo>
    </member>
  </class>
</assembly>

Cheers,

Adam