diff --git a/packages/flutter_tools/lib/src/base/user_messages.dart b/packages/flutter_tools/lib/src/base/user_messages.dart
index 2a5847c53cc..95f67f3b2c6 100644
--- a/packages/flutter_tools/lib/src/base/user_messages.dart
+++ b/packages/flutter_tools/lib/src/base/user_messages.dart
@@ -5,6 +5,12 @@
 import 'context.dart';
 import 'platform.dart';
 
+/// Contains messages produced by Flutter tools.
+//
+// This allows partial reimplementations of the flutter tool to override
+// certain messages.
+// TODO(andrewkolos): It is unclear if this is worth keeping. See
+// https://github.com/flutter/flutter/issues/125155.
 UserMessages get userMessages => context.get<UserMessages>()!;
 
 /// Class containing message strings that can be produced by Flutter tools.