Comment the interface, implementation or both?

Question

I imagine that we all (when we can be bothered!) comment our interfaces. e.g.

/// 

/// Foo Interface
/// 
public interface Fo         


        

Answer 1

C# usage:

Interface can look like this:

    /// 

    /// Helper class to access various properties for the current site.
    /// 
    public interface ISiteHelper
    {
        /// 

        /// Gets the site id of the current site
        /// 
        /// The site id.
        int GetSiteID();
    }
}

Implementation can look like this:

/// 
public class SiteHelper: ISiteHelper
{
    /// 
    public int GetSiteID()
    {
        return CommonRepository.GetSiteID();
    }
}