Stylecop не понимает <наследник />

Я пытаюсь использовать Stylecop 4.7.31 У меня есть проект, где объявлен интерфейс:

public interface IRmlManager
{
    /// <summary>
    /// Adds the notification.
    /// </summary>
    /// <param name="notificationData">The notification data.</param>
    void AddNotification(RmlNotificationData notificationData);
}

и еще один проект, где реализация интерфейса:

public class RmlManager : IRmlManager
{
........
    /// ???
    void AddNotification(RmlNotificationData notificationData);
........
}

если я использую <inheritdoc /> вместо??? Stylecop игнорирует его и выдает ошибки:

BusinessLogic\RmlManager.cs(39,1): error : SA1604: The documentation header must have a summary tag.
BusinessLogic\RmlManager.cs(39,1): error : SA1611: The documentation header must contain param tags matching the element's parameter list.

есть идеи что я делаю не так? По словам Google, Stylecop поддерживает этот тег, начиная примерно с версии 4.1

1 ответ

Ненавижу вам говорить, но Inheritdoc поддерживается StyleCop в соответствии с http://stylecop.codeplex.com/workitem/6637.

Таким образом, можно предположить, что это только специфический экземпляр (т. Е. Он не использует legitdoc, только этот конкретный пример является ошибочным поведением).

Принимая во внимание тот факт, что наследование документов является общепринятым, я бы посоветовал вам обратиться к конкретному списку стилей (откройте обсуждение на их сайте по адресу codeplax по адресу http://stylecop.codeplex.com/discussions), и, возможно, сделайте случай перепроверки и откройте ошибку.

Другие вопросы по тегам