Следует ли писать XML-комментарии для интерфейсов, конкретных реализаций или того и другого? [закрыто]

Меня интересует, где мне следует применить свои XML-комментарии. Должен ли я добавить более общий XML-комментарий в интерфейс и более описательный в реализующий класс? Например:

public interface IObjectRepository
{
    /// <summary>
    ///    Returns an object from the respository that contains the specified ID.
    /// </summary>
    Object GetObject(int Id);
}

public ObjectRepository : IObjectRepository
{
    /// <summary>
    ///    Retrieves an object from the database that contains the specified ID.
    /// </summary>
    public Object GetObject(int Id)
    {
        Object myData = // Get from DB code.
        return myData;
    }
}

Я не включил для простоты.

Это хорошая практика для комментариев или есть другой способ? Я просто пропускаю комментирование интерфейса?

13
задан halfer 24 November 2019 в 17:23
поделиться