Tagged Questions
14
votes
4answers
535 views
Is the “Gets or sets ..” necessary in XML documentation of properties?
I am looking for a recommendation of a best practice for XML comments in C#. When you create a property, it seems like that the expected XML documentation has the following form:
/// <summary>
...
13
votes
2answers
617 views
What is the best approach for inline code comments?
We are doing some refactoring to a 20 years old legacy codebase, and I'm having a discussion with my colleague about the comments format in the code (plsql, java).
There is no a default format for ...
4
votes
1answer
171 views
Looking for VS2010 comments extension/addon
I am trying to track down a VS2010 extension that has the following features ...
Ability to display a list of types/members etc that don't have either inline code comments or documentation comments ...
1
vote
1answer
305 views
instantiate or initialize when using a new class?
my question is rather a matter of English language. For proper commenting my code I want to know when you do for example the following code, what comment you can write for it?
public class TestClass
...
14
votes
3answers
7k views
What javadoc equivalents do you use in .net? [closed]
Java developers use Javadoc in order to write inline documentation in their comments. What are the alternatives for .net - specifically c# and VB.net that people actually use in real world projects?
36
votes
14answers
3k views
Why are /// comment blocks important?
Someone once said we should prefix all our methods with the /// <summary> comment blocks (C#) and I am wondering if that is true or not.
I started to use them and found they annoyed me quite a ...
