From 24f1eac84f44fd9a7c7e68ea1fc9cd1568e66247 Mon Sep 17 00:00:00 2001
From: Birunthan Mohanathas <birunthan@mohanathas.com>
Date: Mon, 4 Feb 2019 09:56:51 +0200
Subject: [PATCH] docs: Recommend use of callback with dialog.showSaveDialog
 (#16649)

See #14606.

Notes: no-notes
---
 docs/api/dialog.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/api/dialog.md b/docs/api/dialog.md
index 870ba685a1a0..45d0a794c216 100644
--- a/docs/api/dialog.md
+++ b/docs/api/dialog.md
@@ -117,6 +117,9 @@ The `filters` specifies an array of file types that can be displayed, see
 If a `callback` is passed, the API call will be asynchronous and the result
 will be passed via `callback(filename)`.
 
+**Note:** On macOS, using the `callback` is recommended to avoid issues when
+expanding and collapsing the dialog.
+
 ### `dialog.showMessageBox([browserWindow, ]options[, callback])`
 
 * `browserWindow` [BrowserWindow](browser-window.md) (optional)