fix docs to remove verbage

Author: iskakaushik

shell/common/display.h

@@ -7,7 +7,7 @@
 
 namespace flutter {
 
-/// Unique IO per display that is stable until the Flutter application restarts.
+/// Unique ID per display that is stable until the Flutter application restarts.
 /// See also: `flutter::Display`
 typedef uint64_t DisplayId;
 
@@ -16,8 +16,7 @@ typedef uint64_t DisplayId;
 /// in such cases. There must only be one screen in such cases.
 static constexpr DisplayId kSingleScreenDeviceId = 0;
 
-/// To be used when the display refresh rate is unknown. This is in frames per
-/// second.
+/// To be used when the display refresh rate is unknown.
 static constexpr double kUnknownDisplayRefreshRate = 0;
 
 /// Display refers to a graphics hardware system consisting of a framebuffer,

shell/platform/embedder/embedder.h

@@ -974,11 +974,9 @@ typedef struct {
 
   FlutterEngineDisplayId display_id;
 
-  /// A double-precision floating-point value representing the actual refresh
-  /// period in seconds. This value may be zero if the device is not running or
-  /// unavaliable or unknown.
+  /// This represents the refresh period in frames per second. This value may be
+  /// zero if the device is not running or unavaliable or unknown.
   double refresh_rate;
-
 } FlutterEngineDisplay;
 
 /// The update type parameter that is passed to