diff --git a/app/src/main/java/nodomain/freeyourgadget/gadgetbridge/util/DeviceHelper.java b/app/src/main/java/nodomain/freeyourgadget/gadgetbridge/util/DeviceHelper.java
index 37bc862b..a562e893 100644
--- a/app/src/main/java/nodomain/freeyourgadget/gadgetbridge/util/DeviceHelper.java
+++ b/app/src/main/java/nodomain/freeyourgadget/gadgetbridge/util/DeviceHelper.java
@@ -64,6 +64,16 @@ public class DeviceHelper {
         return null;
     }
 
+    /**
+     * Returns the list of all available devices that are supported by Gadgetbridge.
+     * Note that no state is known about the returned devices. Even if one of those
+     * devices is connected, it will report the default not-connected state.
+     *
+     * Clients interested in the "live" devices being managed should use the class
+     * DeviceManager.
+     * @param context
+     * @return
+     */
     public Set<GBDevice> getAvailableDevices(Context context) {
         BluetoothAdapter btAdapter = BluetoothAdapter.getDefaultAdapter();