XML 주석(XML Documentation Comments)은 C# 언어에서 사용되는 특별한 주석 형식으로, 코드 요소(메서드, 클래스, 속성 등)에 대한 설명을 담고 있는 문서를 생성합니다.

도큐먼트 주석 작성 가이드

도큐먼트 주석은 ///으로 시작하는 주석으로 작성됩니다.

/// <summary>
/// 두 개의 숫자를 더하는 메서드
/// </summary>
/// <param name="a">첫 번째 숫자</param>
/// <param name="b">두 번째 숫자</param>
/// <returns>두 숫자의 합</returns>
public int Add(int a, int b)
{
    return a + b;
}

XML 주석의 장점

• 코드의 가독성을 높입니다.
• 코드 요소에 대한 설명과 사용 방법을 확인할 수 있습니다.
• API 문서 자동 생성에 활용할 수 있습니다.

참고 문헌

Microsoft Docs: C# XML Documentation Comments

이처럼 C#에서는 도큐먼트 주석과 XML 주석을 통해 코드의 이해도를 높이고, 문서화하여 유지보수를 용이하게 할 수 있습니다.