インターフェイスの実装に関するドキュメントの複製/オーバーライドの良し悪し

だから私たちはそのようなインターフェイスを持っています

/// <summary>
/// Interface for classes capable of creating foos
/// </summary>
public interface ICreatesFoo
{
  /// <summary>
  /// Creates foos
  /// </summary>
  void Create(Foo foo);
  /// <summary>
  /// Does Bar stuff
  /// </summary>
  void Bar();
}

最近、私たちは、上記のようなXML文書がたくさんあることを生成し、確認することを含む文書の話をしました。しかし、これはドキュメントの多くの重複を引き起こしました。実装例：

/// <summary>
/// A Foo Creator which is fast
/// </summary>
public class FastFooCreator : ICreatesFoo
{
  /// <summary>
  /// Creates foos
  /// </summary>
  public void Create(Foo foo)
  {
    //insert code here
  }
  /// <summary>
  /// Does Bar stuff
  /// </summary>
  public void Bar()
  {
    //code here
  }
}

あなたが見ることができるように、メソッドのドキュメントは、インターフェイスからまっすぐです。

大きな問題は、これは悪いことですか？私の腸は重複のために私にイエスと言っていますが、それから再びそうでないかもしれませんか？

また、override関数とvirtual関数を使用した他の同様のドキュメントの複製があります。

これは悪いですか、回避すべきですか？それはまったく価値がありますか？

一般的に、言及する必要のある実装に特定の何かがある場合にのみ、実装のメソッドに新しいドキュメントを追加します。

javadocでは、他のメソッドにリンクできます。これにより、インターフェース内のメソッドドキュメントへの実装にリンクを作成するだけで済みます。私はこれが.Netで行われるべき方法だと思います（私自身の経験ではなく、オンラインドキュメントを読んだことに基づいています）：

/// <summary>
/// Interface for classes capable of creating foos
/// </summary>
public interface ICreatesFoo
{
  /// <summary>
  /// Creates foos
  /// </summary>
  void Create(Foo foo);
  /// <summary>
  /// Does Bar stuff
  /// </summary>
  void Bar();
}

/// <summary>
/// A Foo Creator which is fast
/// </summary>
public class FastFooCreator : ICreatesFoo
{
  /// <summary>
  /// <see cref="ICreatesFoo.Create(Foo)"/>
  /// </summary>
  public void Create(Foo foo)
  {
    //insert code here
  }
  /// <summary>
  /// <see cref="ICreatesFoo.Bar()"/>
  /// Also Note: Implementation of Bar() in FastFooCreator
  /// requires a minimum of 512 MB RAM to Bar the Foo. 
  /// </summary>
  public void Bar()
  {
    //code here
  }
}

<see/>要素のドキュメント：http : //msdn.microsoft.com/en-us/library/acd0tfbe.aspx