Improve code explinations

Author: luispuig

src/smoothscroll.js

@@ -222,11 +222,18 @@ function polyfill() {
       method = scrollElement;
     }
 
-    const maxDistance = Math.max(Math.abs(x - startX), Math.abs(y - startY));
-    const scrollTime = Math.max(
+    // Calculate the maximum distance to scroll in pixels
+    const distanceToScrollX = Math.abs(x - startX);
+    const distanceToScrollY = Math.abs(y - startY);
+    const maxDistanceToScroll = Math.max(distanceToScrollX, distanceToScrollY);
+    // Configure the speed animation in pixels/ms
+    const animationSpeed = 1;
+    // Calculate the time needed for the scroll animation
+    const scrollTime =
+    Math.max(
       MIN_SCROLL_TIME,
-      Math.min(MAX_SCROLL_TIME, maxDistance)
-    );
+      Math.min(MAX_SCROLL_TIME, maxDistanceToScroll)
+    ) * animationSpeed;
 
     // scroll looping over a frame
     step({
@@ -262,8 +269,8 @@ function polyfill() {
         arguments[0].top !== undefined
           ? arguments[0].top
           : arguments[1] !== undefined
-          ? arguments[1]
-          : w.scrollY || w.pageYOffset
+            ? arguments[1]
+            : w.scrollY || w.pageYOffset
       );
 
       return;