improved docstring with concurrency-safe code samples

third_party/bigframes_vendored/pandas/core/frame.py

@@ -2164,7 +2164,12 @@ def map(self, func, na_action: Optional[str] = None) -> DataFrame:
             >>> import bigframes.pandas as bpd
             >>> bpd.options.display.progress_bar = None
 
-            >>> @bpd.remote_function([int], float)
+            Let's use ``reuse=False`` flag to make sure a new ``remote_function``
+            is created every time we run the following code, but you can skip it
+            to potentially reuse a previously deployed ``remote_function`` from
+            the same user defined function.
+
+            >>> @bpd.remote_function([int], float, reuse=False)
             ... def minutes_to_hours(x):
             ...     return x/60
 

third_party/bigframes_vendored/pandas/core/series.py

@@ -735,7 +735,12 @@ def apply(
             >>> import bigframes.pandas as bpd
             >>> bpd.options.display.progress_bar = None
 
-            >>> @bpd.remote_function([int], float)
+            Let's use ``reuse=False`` flag to make sure a new ``remote_function``
+            is created every time we run the following code, but you can skip it
+            to potentially reuse a previously deployed ``remote_function`` from
+            the same user defined function.
+
+            >>> @bpd.remote_function([int], float, reuse=False)
             ... def minutes_to_hours(x):
             ...     return x/60
 
@@ -764,7 +769,6 @@ def apply(
             >>> @bpd.remote_function(
             ...     [str],
             ...     str,
-            ...     bigquery_connection="bigframes-rf-conn",
             ...     reuse=False,
             ...     packages=["cryptography"],
             ... )