[Mono-docs-list] Re: [Mono-list] HTML Mockup for Class Lib Todo's
John Barnette
jbarn@httcb.net
Wed, 13 Feb 2002 00:33:34 -0700
At 10:54 PM 2/12/2002, you wrote:
>Thanks John, I need to spend some of my time digging through all the
>information before I can have an informed opinion.
>
>Nick, I like the XML format you suggested, but until I do that digging I
>don't know how it would relate to John's work.
>
>More reading & learning ahead I feel :-)
The format that Nick proposed is pretty similar to what the mcs/doctools
stuff generates, with some minor additions. Should be at least a good
starting spot.
Oh, and I think that Adam Treat was interested in working on docs stuff
too. Adam? Ping? ;-)
~ j. // Maybe we should take this over to mono-docs-list.
>----- Original Message -----
>From: "John Barnette" <jbarn@httcb.net>
>To: "Nick Drochak" <ndrochak@gol.com>; "Richard Thombs" <mono@stony.org>
>Cc: <mono-list@ximian.com>
>Sent: Monday, February 11, 2002 10:50 PM
>Subject: RE: [Mono-list] HTML Mockup for Class Lib Todo's
>
>
> > At 11:46 PM 2/11/2002, Nick Drochak wrote:
> > >| Might want to check out the mcs/doctools directory, as there's a tool
>in
> > >| there that does a lot of this (percentages, etc) already.
> > >| Improve away. ;-)
> > >
> > >John,
> > >
> > >Right you are. Will do. You've some stuff up on the go-mono site too
> > >right? I'll try to find that as well. The fog is clearing now :)
> >
> > Just a bit, although I'd like to reword that doc to recommend that the
> > external XML docs be identical to XML generated by csc /doc, with the
> > exception of an added "lang" attribute on the root element. That would
> > mean that using NDOC and similar tools will be quite
> > simple. Infrastructure reuse is good. ;-)
> >
> > I haven't been about too terribly much of late, so I'm glad people are
> > taking an interest in documentation issues.
> >
> >
> > ~ j.
> >
> >