diff --git a/src/examples/media-session/access-portal.c b/src/examples/media-session/access-portal.c
index 78036f98b..94d7e7cd5 100644
--- a/src/examples/media-session/access-portal.c
+++ b/src/examples/media-session/access-portal.c
@@ -70,6 +70,11 @@
  * The above properties must be set by the portal initiating the client
  * connection.
  *
+ * See e.g. the [xdg-desktop-portal](github.com/flatpak/xdg-desktop-portal)
+ * for an implementation that sets the above properties. It creates multiple
+ * connections to pipewire, one with `is_portal` set to true for the portal
+ * itself and one connection per application request to open the camera. The
+ * latter have `app_id` and `media_roles` set accordingly.
  */
 #define NAME		"access-portal"
 #define SESSION_KEY	"access-portal"