[java] 인터페이스, 구현 또는 둘 다를 언급하십니까?

나는 우리 모두가 (우리가 귀찮게 할 수있을 때!) 우리의 인터페이스에 대해 논평한다고 상상한다. 예 :

/// <summary>
/// Foo Interface
/// </summary>
public interface Foo
{
    /// <summary>
    /// Will 'bar'
    /// </summary>
    /// <param name="wibble">Wibble factor</param>
    void Bar(string wibble);
}

당신은 또한 구현 (예를 들어 라이브러리의 일부로서 클라이언트에게 제공 될 수있는)에 대해서도 언급하고 있습니까? 그렇다면 둘을 동기화 상태로 유지하는 방법은 무엇입니까? 아니면 ‘문서의 인터페이스 참조’주석 만 추가 하시겠습니까?

감사

답변