Flesh out some docs

diff --git a/docs/api/dialog.md b/docs/api/dialog.md
index 230930abd9481b50dab0fb354b0b1693cb02fb00..71224b69cd4c4e30088b63c92f36b49b1f14926f 100644 (file)
--- a/docs/api/dialog.md
+++ b/docs/api/dialog.md
@@ -175,6 +175,17 @@ it is usually used to report errors in early stage of startup.  If called
 before the app `ready`event on Linux, the message will be emitted to stderr,
 and no GUI dialog will appear.
 
+### `dialog.showCertificateTrustDialog(browserWindow, certificate, message, callback)` _macOS_
+
+* `browserWindow` BrowserWindow
+* `certificate` [Certificate](structures/certificate.md) - The certificate to trust/import.
+* `message` String - The message to display to the user.
+* `callback` Function
+  * `result` Boolean - Whether the user chose to cancel or continue.
+
+Displays a modal dialog that shows a message and certificate information, and
+gives the user the option of trusting/importing the certificate.
+
 ## Sheets
 
 On macOS, dialogs are presented as sheets attached to a window if you provide