tag:blogger.com,1999:blog-190798191079317856.post481304444429029742..comments2018-08-08T04:28:31.456-05:00Comments on Sean Foy: API refs no longer fashionableSean Foyhttp://www.blogger.com/profile/04090757232925761915noreply@blogger.comBlogger2125tag:blogger.com,1999:blog-190798191079317856.post-82829129538340552912009-04-25T13:53:00.000-05:002009-04-25T13:53:00.000-05:00> Info for task consumers is quite different an...> Info for task consumers is quite different and ought to be separate from info for task creators.<br /><br />I agree with you there, Josh.<br /><br />I toyed with the idea of extracting online help for iDeal from doc comments, partly because it seems that doc comments are less likely to go stale than a document separate from code. But even summary contents were often inappropriately technical.<br /><br />I think my favorite manual is still the http://svnbook.red-bean.com/. As far as I know it's maintained by shear discipline (or joy) rather than by any unusually effective technique.Sean Foyhttps://www.blogger.com/profile/04090757232925761915noreply@blogger.comtag:blogger.com,1999:blog-190798191079317856.post-63674465043155569562009-04-23T22:07:00.000-05:002009-04-23T22:07:00.000-05:00Similarly annoying is the "API references offered ...Similarly annoying is the "API references offered up in place of documentation" cop out. MsBuild Community Tasks comes to mind. The only docs I've been able to find are help files generated from code comment xml. It requires one to parse and differentiate the intermingled task developer info from msbuild script developer info. Info for task consumers is quite different and ought to be separate from info for task creators.Josh Buedelhttps://www.blogger.com/profile/09969679943382305665noreply@blogger.com