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