开发者

FxCop or other util to require inline docs in VB.NET? [closed]

开发者 https://www.devze.com 2022-12-14 06:33 出处:网络
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.

We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.

Closed 4 years ago.

Improve this question

I'm starting a new project; trying to be more strict than previous ones. I've set warnings as errors in the build I've added FxCop to PostBuild. The one last thing on my list os require people to add inline docs for all classes/non-private methods/properties.

Is there a custom FxCop rule or 开发者_如何学编程another exe I can run in the post build to check? I've having a hard time finding something, which is surprising.


Bingo: http://www.ookii.org/software/xmlcommentchecker/


The VB.NET compiler doesn't help much in this regard as I've only ever seen it issue a warning for something like <param name="foo">...</param> when you don't have a parameter called "foo" in the function, but nothing at all for missing tags which is annoying.

The method I use on my projects is to use the build log from Sandcastle and grep it for the warnings it spits out since they're faily easy to match (they all begin with something like "Warn: ShowMissingComponent:" and it will issue a warnings for all sorts of missing tags in your code.

0

精彩评论

暂无评论...
验证码 换一张
取 消