Improve documentation

1 files changed, 18 insertions, 1 deletions

diff --git a/src/WixToolset.Extensibility/IMessageListener.cs b/src/WixToolset.Extensibility/IMessageListener.cs
index ea103538..a04e9c98 100644
--- a/src/WixToolset.Extensibility/IMessageListener.cs
+++ b/src/WixToolset.Extensibility/IMessageListener.cs
@@ -5,13 +5,30 @@ namespace WixToolset.Extensibility
     using WixToolset.Data;
     using WixToolset.Extensibility.Services;
 
-#pragma warning disable 1591 // TODO: add documentation
+    /// <summary>
+    /// Message listener.
+    /// </summary>
     public interface IMessageListener
     {
+        /// <summary>
+        /// Calculate a new level for a message.
+        /// </summary>
+        /// <param name="messaging">Messaging object.</param>
+        /// <param name="message">Message to evaluate.</param>
+        /// <param name="defaultMessageLevel">Current message level.</param>
+        /// <returns></returns>
         MessageLevel CalculateMessageLevel(IMessaging messaging, Message message, MessageLevel defaultMessageLevel);
 
+        /// <summary>
+        /// Writes a message.
+        /// </summary>
+        /// <param name="message">Message to write.</param>
         void Write(Message message);
 
+        /// <summary>
+        /// Writes a string message.
+        /// </summary>
+        /// <param name="message">String message to write.</param>
         void Write(string message);
     }
 }