Document haptic timing constants with rationale and performance tradeoffs

bHapticsManager/ModernBHapticsWorkerThread.cs

@@ -16,7 +16,17 @@ private class HapticPointData(HapticPoint point) {
 			public float VibrationPhi { get; set; }
 		}
 
+		// Worker thread update rate: 8ms = 125 Hz
+		// Reduced from 10ms (100 Hz) to 8ms for smoother haptic feedback and better temporal resolution.
+		// Higher update rates provide more responsive haptic effects, particularly for fast-changing
+		// sensations like vibration and pain pulses.
 		private const int UPDATE_INTERVAL_MS = 8;
+
+		// Haptic frame duration: how long each submitted frame persists on the device
+		// Increased from 40ms to 100ms to ensure smooth overlap between frames and prevent gaps.
+		// The 100ms duration (with 8ms updates) provides ~12.5x frame overlap, creating seamless
+		// haptic transitions. Too short a duration can cause perceptible stuttering or dropouts,
+		// while too long can reduce responsiveness to rapid intensity changes.
 		private const int SUBMISSION_DURATION_MS = 100;
 
 		private readonly InputInterface _inputInterface;