[Windows] Address feedback for show window comment (#127998)

Address Tong's feedback here: https://github.com/flutter/flutter/issues/127695#issuecomment-1564884872

Follow-up to: https://github.com/flutter/flutter/pull/127046

dev/integration_tests/flutter_gallery/windows/runner/flutter_window.cpp

@@ -36,8 +36,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

dev/integration_tests/ui/windows/runner/flutter_window.cpp

@@ -36,8 +36,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

dev/integration_tests/windows_startup_test/windows/runner/flutter_window.cpp

@@ -64,8 +64,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   // Create a method channel to check the window's visibility.

dev/manual_tests/windows/runner/flutter_window.cpp

@@ -36,8 +36,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

examples/flutter_view/windows/runner/flutter_window.cpp

@@ -36,8 +36,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

examples/hello_world/windows/runner/flutter_window.cpp

@@ -36,8 +36,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

examples/layers/windows/runner/flutter_window.cpp

@@ -36,8 +36,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

examples/platform_channel/windows/runner/flutter_window.cpp

@@ -99,8 +99,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

packages/flutter_tools/lib/src/windows/migrations/show_window_migration.dart

@@ -20,8 +20,8 @@ const String _after = r'''
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

packages/flutter_tools/templates/app_shared/windows.tmpl/runner/flutter_window.cpp

@@ -32,8 +32,8 @@ bool FlutterWindow::OnCreate() {
   });
 
   // Flutter can complete the first frame before the "show window" callback is
-  // registered. Ensure a frame is pending to ensure the window is shown.
-  // This no-ops if the first frame hasn't completed yet.
+  // registered. The following call ensures a frame is pending to ensure the
+  // window is shown. It is a no-op if the first frame hasn't completed yet.
   flutter_controller_->ForceRedraw();
 
   return true;

packages/flutter_tools/test/general.shard/windows/migrations/show_window_migration_test.dart

@@ -75,8 +75,8 @@ void main () {
         '  });\n'
         '\n'
         '  // Flutter can complete the first frame before the "show window" callback is\n'
-        '  // registered. Ensure a frame is pending to ensure the window is shown.\n'
-        "  // This no-ops if the first frame hasn't completed yet.\n"
+        '  // registered. The following call ensures a frame is pending to ensure the\n'
+        "  // window is shown. It is a no-op if the first frame hasn't completed yet.\n"
         '  flutter_controller_->ForceRedraw();\n'
         '\n'
         '  return true;\n';
@@ -103,8 +103,8 @@ void main () {
         '  });\r\n'
         '\r\n'
         '  // Flutter can complete the first frame before the "show window" callback is\r\n'
-        '  // registered. Ensure a frame is pending to ensure the window is shown.\r\n'
-        "  // This no-ops if the first frame hasn't completed yet.\r\n"
+        '  // registered. The following call ensures a frame is pending to ensure the\r\n'
+        "  // window is shown. It is a no-op if the first frame hasn't completed yet.\r\n"
         '  flutter_controller_->ForceRedraw();\r\n'
         '\r\n'
         '  return true;\r\n';
@@ -145,8 +145,8 @@ void main () {
         '  });\n'
         '\n'
         '  // Flutter can complete the first frame before the "show window" callback is\n'
-        '  // registered. Ensure a frame is pending to ensure the window is shown.\n'
-        "  // This no-ops if the first frame hasn't completed yet.\n"
+        '  // registered. The following call ensures a frame is pending to ensure the\n'
+        "  // window is shown. It is a no-op if the first frame hasn't completed yet.\n"
         '  flutter_controller_->ForceRedraw();\n'
         '\n'
         '  return true;\n'
@@ -176,8 +176,8 @@ void main () {
         '  });\r\n'
         '\r\n'
         '  // Flutter can complete the first frame before the "show window" callback is\r\n'
-        '  // registered. Ensure a frame is pending to ensure the window is shown.\r\n'
-        "  // This no-ops if the first frame hasn't completed yet.\r\n"
+        '  // registered. The following call ensures a frame is pending to ensure the\r\n'
+        "  // window is shown. It is a no-op if the first frame hasn't completed yet.\r\n"
         '  flutter_controller_->ForceRedraw();\r\n'
         '\r\n'
         '  return true;\r\n'