JavaDoc has an @inheritDoc attribute to indicate that a member which is overriding a base class member, or implementing an interface member, inherits its documentation from that member. Support for this feature is growing in the .NET community (e.g.
) and is something that is extremely useful when working in service-oriented applications where interfaces define implementations, and then classes provided by an IoC container provide the implementation.
Ideally if a member is annotated with this, StyleCop should check that it does either implement an interface or override a base class method and raise an error saying you cannot use <inheritdoc/> if it doesn't; if it does then it should ignore any documentation
validation rules for that member. Inheritdoc can be used in many complex ways :see