From 54c6ff2f3cea67e684a2134d340f8ecd772e9b6c Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Wed, 19 Jul 2023 12:32:22 +0200
Subject: [PATCH] docs: clarify the path attribute of InstalledBrowser (#10588)

---
 docs/browsers-api/browsers.installedbrowser.md | 12 ++++++------
 packages/browsers/src/Cache.ts                 |  4 ++++
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/docs/browsers-api/browsers.installedbrowser.md b/docs/browsers-api/browsers.installedbrowser.md
index 9b4fb7bd429..a7cc2dc894f 100644
--- a/docs/browsers-api/browsers.installedbrowser.md
+++ b/docs/browsers-api/browsers.installedbrowser.md
@@ -12,9 +12,9 @@ export interface InstalledBrowser
 
 ## Properties
 
-| Property | Modifiers | Type                                             | Description | Default |
-| -------- | --------- | ------------------------------------------------ | ----------- | ------- |
-| browser  |           | [Browser](./browsers.browser.md)                 |             |         |
-| buildId  |           | string                                           |             |         |
-| path     |           | string                                           |             |         |
-| platform |           | [BrowserPlatform](./browsers.browserplatform.md) |             |         |
+| Property | Modifiers | Type                                             | Description                                                                                                                                               | Default |
+| -------- | --------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
+| browser  |           | [Browser](./browsers.browser.md)                 |                                                                                                                                                           |         |
+| buildId  |           | string                                           |                                                                                                                                                           |         |
+| path     |           | string                                           | Path to the root of the installation folder. Use [computeExecutablePath()](./browsers.computeexecutablepath.md) to get the path to the executable binary. |         |
+| platform |           | [BrowserPlatform](./browsers.browserplatform.md) |                                                                                                                                                           |         |
diff --git a/packages/browsers/src/Cache.ts b/packages/browsers/src/Cache.ts
index 06bc5ae54b7..7a588396490 100644
--- a/packages/browsers/src/Cache.ts
+++ b/packages/browsers/src/Cache.ts
@@ -23,6 +23,10 @@ import {Browser, BrowserPlatform} from './browser-data/browser-data.js';
  * @public
  */
 export interface InstalledBrowser {
+  /**
+   * Path to the root of the installation folder. Use
+   * {@link computeExecutablePath} to get the path to the executable binary.
+   */
   path: string;
   browser: Browser;
   buildId: string;