feat: mark Watch methods as obsolete to prepare for future deprecation

Author: lqlive

src/KubernetesClient/WatcherExt.cs

@@ -16,6 +16,7 @@ public static class WatcherExt
         /// The action to invoke when the server closes the connection.
         /// </param>
         /// <returns>a watch object</returns>
+        [Obsolete("This method will be deprecated in future versions.")] 
         public static Watcher<T> Watch<T, L>(
             this Task<HttpOperationResponse<L>> responseTask,
             Action<WatchEventType, T> onEvent,
@@ -52,6 +53,7 @@ private static Func<Task<TextReader>> MakeStreamReaderCreator<T, L>(Task<HttpOpe
         /// The action to invoke when the server closes the connection.
         /// </param>
         /// <returns>a watch object</returns>
+        [Obsolete("This method will be deprecated in future versions.")] 
         public static Watcher<T> Watch<T, L>(
             this HttpOperationResponse<L> response,
             Action<WatchEventType, T> onEvent,
@@ -71,6 +73,7 @@ public static Watcher<T> Watch<T, L>(
         /// <param name="onError">a callback when any exception was caught during watching</param>
         /// <param name="cancellationToken">cancellation token</param>
         /// <returns>IAsyncEnumerable of watch events</returns>
+        [Obsolete("This method will be deprecated in future versions.")] 
         public static IAsyncEnumerable<(WatchEventType, T)> WatchAsync<T, L>(
             this Task<HttpOperationResponse<L>> responseTask,
             Action<Exception> onError = null,

src/LibKubernetesGenerator/templates/IOperations.cs.template

@@ -25,9 +25,6 @@ public partial interface I{{name}}Operations
     /// <param name="cancellationToken">
     /// A <see cref="CancellationToken"/> which can be used to cancel the asynchronous operation.
     /// </param>
-    {{if IfParamContains api.operation "watch"}}  
-    [Obsolete("This method will be deprecated in future versions. Please use the Watch method instead.")] 
-    {{end}}
     Task<HttpOperationResponse{{GetReturnType api.operation "<>"}}> {{GetOperationId api.operation "WithHttpMessagesAsync"}}(
 {{ for parameter in api.operation.parameters}}
         {{GetDotNetTypeOpenApiParameter parameter}} {{GetDotNetNameOpenApiParameter parameter "true"}},