From 7c4529a01a09845b208919ff46a87416a772e934 Mon Sep 17 00:00:00 2001
From: Zeke Sikelianos <zeke@sikelianos.com>
Date: Wed, 22 Feb 2017 16:42:34 -0800
Subject: [PATCH] clarify actions that cause app.activate event to be emitted

---
 docs/api/app.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/api/app.md b/docs/api/app.md
index d34daeddde78..77b1e5fa21b9 100644
--- a/docs/api/app.md
+++ b/docs/api/app.md
@@ -125,8 +125,10 @@ Returns:
 * `event` Event
 * `hasVisibleWindows` Boolean
 
-Emitted when the application is activated, which usually happens when the user
-clicks on the application's dock icon.
+Emitted when the application is activated. Various actions can trigger
+this event, such as launching the application for the first time, attempting
+to re-launch the application when it's already running, or clicking on the 
+application's dock or taskbar icon.
 
 ### Event: 'continue-activity' _macOS_