diff --git a/packages/devtools_app/lib/src/shared/development_helpers.dart b/packages/devtools_app/lib/src/shared/development_helpers.dart
index 8e9bb39b7ba..039fd01aa2a 100644
--- a/packages/devtools_app/lib/src/shared/development_helpers.dart
+++ b/packages/devtools_app/lib/src/shared/development_helpers.dart
@@ -210,12 +210,12 @@ abstract class StubDevToolsExtensions {
 ///
 /// When this flag is true, [debugSurveyMetadata] will be used instead of what
 /// we normally fetch from
-/// 'docs.flutter.dev/f/dart-devtools-survey-metadata.json'.
+/// 'https://storage.googleapis.com/flutter-uxr/surveys/devtools-survey-metadata.json'.
 bool debugSurvey = false;
 
 /// The survey metadata that will be used instead of the live data from
-/// 'docs.flutter.dev/f/dart-devtools-survey-metadata.json' when [debugSurvey]
-/// is true;
+/// 'https://storage.googleapis.com/flutter-uxr/surveys/devtools-survey-metadata.json'
+/// when [debugSurvey] is true.
 final debugSurveyMetadata = DevToolsSurvey.fromJson(
   {
     '_comments': [
diff --git a/packages/devtools_app/lib/src/shared/survey.dart b/packages/devtools_app/lib/src/shared/survey.dart
index eb9cd980430..1e726cd8d68 100644
--- a/packages/devtools_app/lib/src/shared/survey.dart
+++ b/packages/devtools_app/lib/src/shared/survey.dart
@@ -27,6 +27,13 @@ class SurveyService {
 
   static const _maxShowSurveyCount = 5;
 
+  /// The URL that we will fetch the DevTools survey metadata from.
+  ///
+  /// To run new surveys, update the content at
+  /// https://github.com/flutter/uxr/blob/master/surveys/devtools-survey-metadata.json.
+  ///
+  /// This content will be propagated to the storage.googleapis.com domain
+  /// automatically.
   static final _metadataUrl = Uri.https(
     'storage.googleapis.com',
     'flutter-uxr/surveys/devtools-survey-metadata.json',