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