Лучшие практики для визуальной студии XML документации подклассов?

Программирование в VS 2013 C++ и наших стандартах doc требует XML-документации, отчасти поэтому комментарии появляются в IntelliSense. Моя проблема в том, что IntelliSense не наследует документацию от базовых классов, поэтому, если у меня есть что-то вроде этого:

class Base {
public:
    Base() {}
    /// <summary> Really detailed and insightful comments </summary>
    virtual void method() = 0;
};

class Derived : public Base {
    Derived() {}
    void method() override {}
}

Typing

Base b;
b.method();   <- Gives nice IntelliSense tips
Derived d;
d.method();      <- Just shows +1 Override

Я мог бы скопировать и вставить комментарии, но на самом деле не хочу нарушать принцип СУХОГО. У меня есть поиск, а ReFactor и другие инструменты могут помочь синхронизировать комментарии, но наша компания скромна, поэтому на данный момент не вариант. Какие-нибудь из готовых или бесплатных предложений? Моя мысль состоит в том, чтобы добавить строку

/// <summary> see base class for documentation </summary>

выше переопределенные методы, но предпочли бы что-то, что показало бы подсказки IntelliSense в базовом классе.

0 ответов

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