doc amendments

Moved new docs to <remarks> section, and improved wording.

Author: duckets

Packages/com.unity.inputsystem/InputSystem/Devices/Mouse.cs

@@ -23,23 +23,25 @@ public struct MouseState : IInputStateTypeInfo
         public static FourCC Format => new FourCC('M', 'O', 'U', 'S');
 
         /// <summary>
-        /// Screen-space position of the mouse in pixels. May be updated independently from delta depending on the platform. At high framerates, certain frames might not receive any new position data. If a delta is needed that correlates with position, compute it based on the last reported position.
+        /// Screen-space position of the mouse in pixels.
         /// </summary>
         /// <value>Position of mouse on screen.</value>
         /// <remarks>
         /// On Windows, delta originates from RAWINPUT API.
+        /// Note: This value might not update every frame, particularly if your project is running at a high frame rates. This value might also update at a different time than the <see cref="Pointer.delta"/>. If you need a delta value that correlates with position, you should compute it based on the previous position value.
         /// </remarks>
         /// <seealso cref="Pointer.position"/>
         [InputControl(usage = "Point", dontReset = true)] // Mouse should stay put when we reset devices.
         [FieldOffset(0)]
         public Vector2 position;
 
         /// <summary>
-        /// Screen-space motion delta of the mouse in pixels. May be updated independently from position depending on the platform. At high framerates, certain frames might not receive any new delta data. If a delta is needed that correlates with position, compute it based on the last reported position.
+        /// Screen-space motion delta of the mouse in pixels.
         /// </summary>
         /// <value>Mouse movement.</value>
         /// <remarks>
         /// On Windows, delta originates from RAWINPUT API.
+        /// Note: This value might not update every frame, particularly if your project is running at a high frame rates. This value might also update at a different time than the <see cref="Pointer.position"/>. If you need a delta value that correlates with position, you should compute it based on the previous position value.
         /// </remarks>
         /// <seealso cref="Pointer.delta"/>
         [InputControl(usage = "Secondary2DMotion", layout = "Delta")]