diff --git a/app/src/main/java/org/fdroid/fdroid/AppUpdateStatusManager.java b/app/src/main/java/org/fdroid/fdroid/AppUpdateStatusManager.java
index 8ca9fa56d..91d5b965f 100644
--- a/app/src/main/java/org/fdroid/fdroid/AppUpdateStatusManager.java
+++ b/app/src/main/java/org/fdroid/fdroid/AppUpdateStatusManager.java
@@ -35,12 +35,39 @@ import java.util.Map;
  */
 public final class AppUpdateStatusManager {
 
-    static final String BROADCAST_APPSTATUS_LIST_CHANGED = "org.fdroid.fdroid.installer.appstatus.listchange";
-    static final String BROADCAST_APPSTATUS_ADDED = "org.fdroid.fdroid.installer.appstatus.appchange.add";
-    static final String BROADCAST_APPSTATUS_CHANGED = "org.fdroid.fdroid.installer.appstatus.appchange.change";
-    static final String BROADCAST_APPSTATUS_REMOVED = "org.fdroid.fdroid.installer.appstatus.appchange.remove";
-    static final String EXTRA_APK_URL = "urlstring";
-    static final String EXTRA_IS_STATUS_UPDATE = "isstatusupdate";
+    /**
+     * Broadcast when:
+     *  * The user clears the list of installed apps from notification manager.
+     *  * The user clears the list of apps available to update from the notification manager.
+     *  * A repo update is completed and a bunch of new apps are ready to be updated.
+     */
+    public static final String BROADCAST_APPSTATUS_LIST_CHANGED = "org.fdroid.fdroid.installer.appstatus.listchange";
+
+    /**
+     * Broadcast when an app begins the download/install process (either manually or via an automatic download).
+     */
+    public static final String BROADCAST_APPSTATUS_ADDED = "org.fdroid.fdroid.installer.appstatus.appchange.add";
+
+    /**
+     * When the {@link AppUpdateStatus#status} of an app changes or the download progress for an app advances.
+     */
+    public static final String BROADCAST_APPSTATUS_CHANGED = "org.fdroid.fdroid.installer.appstatus.appchange.change";
+
+    /**
+     * Broadcast when:
+     *  * The associated app has the {@link Status#Installed} status, and the user either visits
+     *    that apps details page or clears the individual notification for the app.
+     *  * The download for an app is cancelled.
+     */
+    public static final String BROADCAST_APPSTATUS_REMOVED = "org.fdroid.fdroid.installer.appstatus.appchange.remove";
+
+    public static final String EXTRA_APK_URL = "urlstring";
+
+    /**
+     * If this is present and true, then the broadcast has been sent in response to the {@link AppUpdateStatus#status}
+     * changing. In comparison, if it is just the download progress of an app then this should not be true.
+     */
+    public static final String EXTRA_IS_STATUS_UPDATE = "isstatusupdate";
 
     private static final String LOGTAG = "AppUpdateStatusManager";