Repository: electron/electron (language: cpp)

Issue:
Security scoped bookmarks documentation is incorrect about supported methods
### Preflight Checklist

- [x] I have read the [Contributing Guidelines](https://github.com/electron/electron/blob/main/CONTRIBUTING.md) for this project.
- [x] I agree to follow the [Code of Conduct](https://github.com/electron/electron/blob/main/CODE_OF_CONDUCT.md) that this project adheres to.
- [x] I have searched the [issue tracker](https://www.github.com/electron/electron/issues) for a bug report that matches the one I want to file, without success.

### Electron Version

31.0.2

### What operating system(s) are you using?

macOS

### Operating System Version

macOS Sequoia 15.1.1

### What arch are you using?

arm64 (including Apple Silicon)

### Last Known Working Electron version

_No response_

### Expected Behavior

1. I call `dialog.showOpenDialogSync ` with the `securityScopedBookmarks` option set to true.
2. The user successfully selects a file
3. The security scoped bookmark data is returned from the function

### Actual Behavior

The return value of `dialog.showOpenDialogSync` is just a list of filenames. No bookmark data is returned.

### Testcase Gist URL

_No response_

### Additional Information

The documentation also seems to be explicitly wrong when stating that this function can return bookmarks.

[dialog.showOpenDialogSync](https://www.electronjs.org/docs/latest/api/dialog#bookmarks-array) 


Discussion / hints:

Fix patch:
diff --git a/docs/api/dialog.md b/docs/api/dialog.md
index 81458ddece3b8..27590bf6c209c 100644
--- a/docs/api/dialog.md
+++ b/docs/api/dialog.md
@@ -360,7 +360,7 @@ On Windows the options are more limited, due to the Win32 APIs used:
 
 ## Bookmarks array
 
-`showOpenDialog`, `showOpenDialogSync`, `showSaveDialog`, and `showSaveDialogSync` will return a `bookmarks` array.
+`showOpenDialog` and `showSaveDialog` resolve to an object with a `bookmarks` field. This field is an array of Base64 encoded strings that contain the [security scoped bookmark](https://developer.apple.com/library/content/documentation/Security/Conceptual/AppSandboxDesignGuide/AppSandboxInDepth/AppSandboxInDepth.html#//apple_ref/doc/uid/TP40011183-CH3-SW16) data for the saved file. The `securityScopedBookmarks` option must be enabled for this to be present.
 
 | Build Type | securityScopedBookmarks boolean | Return Type | Return Value                   |
 |------------|---------------------------------|:-----------:|--------------------------------|


Test patch: