Лучшие практики для визуальной студии 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 в базовом классе.