pydbus.bus: bluez: better notes on the empty dicts

Author: Tatsh

stubs/pydbus/pydbus/bus.pyi

@@ -129,6 +129,7 @@ class OrgBluezNetwork1Dict(TypedDict, total=False):
     UUID: str
 
 # This is for keys under /org/bluez/hci0/*
+# Refer to https://github.com/bluez/bluez/blob/master/doc/ for interface details
 _OrgBluezDict = TypedDict(
     "_OrgBluezDict",
     {
@@ -143,18 +144,13 @@ _OrgBluezDict = TypedDict(
         "org.bluez.Media1": OrgBluezMedia1Dict,
         "org.bluez.Network1": OrgBluezNetwork1Dict,
         "org.bluez.MediaControl1": OrgBluezMediaControl1Dict,
-        # Dicts below are always empty because they have no properties.
-        # https://github.com/bluez/bluez/blob/master/doc/org.bluez.AgentManager.rst
+        # Dicts below are always empty because they have no properties. However, the key existence may still be useful
+        # for introspection.
         "org.bluez.AgentManager1": dict[str, Any],
-        # https://github.com/bluez/bluez/blob/master/doc/org.bluez.BatteryProviderManager.rst
         "org.bluez.BatteryProviderManager1": dict[str, Any],
-        # https://github.com/bluez/bluez/blob/master/doc/org.bluez.NetworkServer.rst
         "org.bluez.NetworkServer1": dict[str, Any],
-        # https://github.com/bluez/bluez/blob/master/doc/org.bluez.ProfileManager.rst
         "org.bluez.ProfileManager1": dict[str, Any],
-        # https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-introspectable
         "org.freedesktop.DBus.Introspectable": dict[str, Any],
-        # https://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties
         "org.freedesktop.DBus.Properties": dict[str, Any],
     },
     total=False,