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

John Barnette jbarn@httcb.net
Tue, 05 Mar 2002 12:10:11 -0700


At 11:59 AM 3/5/2002, you wrote:
> > 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.

Adam,

Is there any particular reason not to use the XML schema that csc /doc uses 
for our external documentation?  I think we might have touched on this 
before, but not gotten into details.  It would certainly make integration 
with third-party tools like NDOC easier.


~ j.