Question

Stylecop is telling me to use /// instead of // when I´m commenting. What is the semantic difference for those two and when should I use which one?

Answer 1

// denotes your own personal comments, where /// denote comments that can contain special data, e.g. markup for interpretation by Visual Studio – like:

/// <summary> /// This class does something. /// </summary> class Bob {     ... } 

This will tell Visual Studio the summary of the Bob class, and that will then show up in your code completion box.