After reading this thread it made me think of a recent blog posting I saw: http://blogs.msdn.com/petertaylor/archive/2004/05/04/125834.aspx. The blog entry is about the development of the Longhorn SDK documentation which can be found at http://longhorn.msdn.microsoft.com/.
What's interesting about the blog entry and relates well to Mozilla is how the MSDN group pulls and generates the SDK documentation. They have a system which sounds similar to doxygen that pulls metadata from the code and creates xml documents that describes all of the API. These xml documents are then transformed using xslt to what is seen on the web. Example and other comments are inserted using some cross-referencing system.
I think this would be a very interesting project and if there was interest from the Mozilla side, something that I could investigate.
Good post, but it belongs in m.documentation.
Also, Monodoc exists and it does somethings we may want. Shaver got it going, and gave Axel a pointer or two so he could use and evaluate it (news://news.mozilla.org:119/[EMAIL PROTECTED], news://news.mozilla.org:119/[EMAIL PROTECTED]).
Monodoc's creators decided against in-code docs that can be extracted automatically, IIRC because they'd take up more room in doc-comments than the code, especially with every localization stored _in situ_.
Anyone else have Monodoc experience?
/be _______________________________________________ mozilla-documentation mailing list [EMAIL PROTECTED] http://mail.mozilla.org/listinfo/mozilla-documentation
