diff --git a/lib/src/channel_factory_web.dart b/lib/src/channel_factory_web.dart
index 565f4be..bd00026 100644
--- a/lib/src/channel_factory_web.dart
+++ b/lib/src/channel_factory_web.dart
@@ -1,8 +1,10 @@
 // Web channel factory — gRPC-Web over HTTP/1.1.
-// Selected on dart:html targets (Flutter web, Dart-for-web) via
-// the conditional import in hub_client.dart. The hub must be
-// running with `tonic-web` enabled — see fai_platform docs
-// architecture/protocol-surfaces.md.
+// Selected on dart:html targets (Flutter web, Dart-for-web) via the
+// conditional import in hub_client.dart. The hub serves gRPC-Web on the
+// same port as native gRPC (tonic-web) and, on a loopback bind, allows
+// any browser origin (CORS); for a remote bind set
+// `security.cors_allowed_origins`. See the chain repo's
+// docs/architecture/protocol-surfaces.md.
 
 import 'package:grpc/grpc_connection_interface.dart';
 import 'package:grpc/grpc_web.dart';