update comment

Author: parthea

gapic/templates/%namespace/%name_%version/%sub/services/%service/_shared_macros.j2

@@ -383,10 +383,12 @@ class {{ async_method_name_prefix }}{{ service.name }}RestInterceptor:
     {% endif %}
         """Post-rpc interceptor for {{ method.name|snake_case }}
 
-        Override in a subclass to manipulate the response
+        Deprecated. Override in a subclass to read or manipulate the response
         after it is returned by the {{ service.name }} server but before
         it is returned to user code. This `post_{{ method.name|snake_case }}` iterceptor runs
-        before the `post_{{ method.name|snake_case }}_with_metadata` iterceptor.
+        before the `post_{{ method.name|snake_case }}_with_metadata` iterceptor. This
+        interceptor is deprecated. Please use the `post_{{ method.name|snake_case }}_with_metadata`
+        interceptor instead.
         """
         return response
 
@@ -397,12 +399,13 @@ class {{ async_method_name_prefix }}{{ service.name }}RestInterceptor:
     {% endif %}
         """Post-rpc interceptor for {{ method.name|snake_case }}
 
-        Override in a subclass to either manipulate or read, either the response
-        or metadata after it is returned by the {{ service.name }} server but before
-        it is returned to user code. This `post_{{ method.name|snake_case }}_with_metadata`
-        interceptor runs after the `post_{{ method.name|snake_case }}` iterceptor. This
-        `post_{{ method.name|snake_case }}_with_metadata` interceptor is recommended for
-        new development instead of `post_{{ method.name|snake_case }}`.
+        Override in a subclass to read or manipulate the response or metadata after it
+        is returned by the {{ service.name }} server but before it is returned to user code.
+        This `post_{{ method.name|snake_case }}_with_metadata` interceptor runs after the
+        `post_{{ method.name|snake_case }}` iterceptor. If the response is modified in
+        `post_{{ method.name|snake_case }}`, the modified response will be used in
+        `post_{{ method.name|snake_case }}_with_metadata. This `post_{{ method.name|snake_case }}_with_metadata`
+        interceptor is recommended for new development instead of `post_{{ method.name|snake_case }}`.
         """
         return response, metadata