Wednesday, February 23, 2005
Great Documenting Tool
I was reading some of Ben Carey's older blog posts and ran across this reference to GhostDoc, a terrific commenting tool for Visual Studio.
Sure, hitting the slash key three times above a method or variable will give you a template, but GhostDoc takes that a step further by generating useful text to fill in fields for those comment templates -- including generating documentation for method parameters and return values.
GhostDoc looks at your method and variable names, infers a few things and plops in reasonable comments. It's almost a completely hands-off task to document if you've done a good job naming your methods, method parameters, and variables. (You have read your McConnell, haven't you???)
No comments:
Post a Comment