docs: clarify dock.bounce usage (electron#20458)

codebytere · web-flow · commit 15e611a0ff49 · 2019-10-07T17:15:48.000+02:00
diff --git a/docs/api/app.md b/docs/api/app.md
@@ -1285,14 +1285,16 @@ you exactly what went wrong
 * `type` String (optional) - Can be `critical` or `informational`. The default is
  `informational`
 
+Returns `Integer` an ID representing the request.
+
 When `critical` is passed, the dock icon will bounce until either the
 application becomes active or the request is canceled.
 
 When `informational` is passed, the dock icon will bounce for one second.
 However, the request remains active until either the application becomes active
 or the request is canceled.
 
-Returns `Integer` an ID representing the request.
+**Nota Bene:** This method can only be used while the app is not focused; when the app is focused it will return -1.
 
 ### `app.dock.cancelBounce(id)` _macOS_
 
