fix: Update get_browser_path docstring

CHANGELOG.md

@@ -16,6 +16,7 @@ where X.Y.Z is the semver of the most recent choreographer release.
 ### Fixed
 - Improve platform architecture detection for arm on Linux and Windows [[#290](https://github.com/plotly/choreographer/pull/290)], with thanks to @juliabeliaeva for the contribution!
 - Fix license file and add a valid SPDX identifier to project settings [[#294](https://github.com/plotly/choreographer/pull/294)], with thanks to @ecederstrand for the contribution!
+- Fix out-of-date docstring on `get_browser_path` [[#300](https://github.com/plotly/choreographer/issues/300)]
 
 
 ## [1.3.0] -- 2026-04-28

src/choreographer/utils/_which.py

@@ -79,13 +79,20 @@ def get_browser_path(*args: Any, **kwargs: Any) -> str | None:  # noqa: D417, do
     """
     Call `browser_which()` but check for user override first.
 
-    It looks for the browser in path.
+    Returns the path set by the ``BROWSER_PATH`` environment variable if set,
+    otherwise searches ``PATH`` via `browser_which()`.
 
-    Accepts the same arguments as `browser_which':
+    Accepts the same arguments as `browser_which()`:
 
     Args:
         executable_names: the list of names to look for
-        skip_local: (default False) don't look for a choreo download of anything.
+        ms_prog_id: A windows registry ID string to lookup program paths
+
+    Note:
+        This function does not handle the choreographer-managed local browser
+        download. To include (or skip) a locally downloaded browser in the
+        search, use `choreographer.browsers.chromium.Chromium.find_browser`,
+        which accepts a ``skip_local`` argument.
 
     """
     return os.environ.get("BROWSER_PATH", browser_which(*args, **kwargs))