diff --git a/gio/gnetworkmonitor.c b/gio/gnetworkmonitor.c
index c59caee84..db57d90cb 100644
--- a/gio/gnetworkmonitor.c
+++ b/gio/gnetworkmonitor.c
@@ -35,8 +35,11 @@
  * @include: gio/gio.h
  *
  * #GNetworkMonitor provides an easy-to-use cross-platform API
- * for monitoring network connectivity. On Linux, the implementation
- * is based on the kernel's netlink interface.
+ * for monitoring network connectivity. On Linux, the available
+ * implementations are based on the kernel's netlink interface and
+ * on NetworkManager.
+ *
+ * There is also an implmeentation for use inside Flatpak sandboxes.
  */
 
 /**
diff --git a/gio/gproxyresolver.c b/gio/gproxyresolver.c
index c9418ceab..b3bdec3b9 100644
--- a/gio/gproxyresolver.c
+++ b/gio/gproxyresolver.c
@@ -38,6 +38,10 @@
  * #GProxyResolver provides synchronous and asynchronous network proxy
  * resolution. #GProxyResolver is used within #GSocketClient through
  * the method g_socket_connectable_proxy_enumerate().
+ *
+ * Implementations of #GProxyResolver based on libproxy and GNOME settings can
+ * be found in glib-networking. GIO comes with an implementation for use inside
+ * FLatpak portals.
  */
 
 /**