add some doc for watcher

Author: tg123

src/Watcher.cs

@@ -22,12 +22,15 @@ public enum WatchEventType
 
     public class Watcher<T> : IDisposable
     {
+        /// <summary>
+        /// indicate if the watch object is alive
+        /// </summary>
         public bool Watching { get; private set; }
 
         private readonly CancellationTokenSource _cts;
         private readonly StreamReader _streamReader;
 
-        public Watcher(StreamReader streamReader, Action<WatchEventType, T> onEvent, Action<Exception> onError)
+        internal Watcher(StreamReader streamReader, Action<WatchEventType, T> onEvent, Action<Exception> onError)
         {
             _streamReader = streamReader;
             OnEvent += onEvent;
@@ -82,7 +85,14 @@ public void Dispose()
             _streamReader.Dispose();
         }
 
+        /// <summary>
+        /// add/remove callbacks when any event raised from api server
+        /// </summary>
         public event Action<WatchEventType, T> OnEvent;
+
+        /// <summary>
+        /// add/remove callbacks when any exception was caught during watching
+        /// </summary>
         public event Action<Exception> OnError;
 
         public class WatchEvent
@@ -95,6 +105,14 @@ public class WatchEvent
 
     public static class WatcherExt
     {
+        /// <summary>
+        /// create a watch object from a call to api server with watch=true
+        /// </summary>
+        /// <typeparam name="T">type of the event object</typeparam>
+        /// <param name="response">the api response</param>
+        /// <param name="onEvent">a callback when any event raised from api server</param>
+        /// <param name="onError">a callbak when any exception was caught during watching</param>
+        /// <returns>a watch object</returns>
         public static Watcher<T> Watch<T>(this HttpOperationResponse response,
             Action<WatchEventType, T> onEvent,
             Action<Exception> onError = null)
@@ -107,6 +125,14 @@ public static Watcher<T> Watch<T>(this HttpOperationResponse response,
             return new Watcher<T>(content.StreamReader, onEvent, onError);
         }
 
+        /// <summary>
+        /// create a watch object from a call to api server with watch=true
+        /// </summary>
+        /// <typeparam name="T">type of the event object</typeparam>
+        /// <param name="response">the api response</param>
+        /// <param name="onEvent">a callback when any event raised from api server</param>
+        /// <param name="onError">a callbak when any exception was caught during watching</param>
+        /// <returns>a watch object</returns>
         public static Watcher<T> Watch<T>(this HttpOperationResponse<T> response,
             Action<WatchEventType, T> onEvent,
             Action<Exception> onError = null)

src/WatcherDelegatingHandler.cs

@@ -6,6 +6,10 @@
 
 namespace k8s
 {
+    /// <summary>
+    /// This HttpDelegatingHandler is to rewrite the response and return first line to autorest client
+    /// then use WatchExt to create a watch object which interact with the replaced http response to get watch works.
+    /// </summary>
     internal class WatcherDelegatingHandler : DelegatingHandler
     {
         protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request,