Goodbye DOMTimeStamp, hello DOMHighResTimeStamp (#334)

* Update index.bs

* Update index.bs

Co-authored-by: Amy Guy <[email protected]>

* Update index.bs

* Update index.bs

Co-authored-by: Amy Guy <[email protected]>

Co-authored-by: Amy Guy <[email protected]>

Author: cynthia

index.bs

@@ -2106,11 +2106,14 @@ not as an integer value of a smaller time unit like nanoseconds.
 
 <h3 id="times-and-dates">Use the appropriate type to represent times and dates</h3>
 
-When representing date-times on the platform, use the {{DOMTimeStamp}} type.
-Use {{DOMHighResTimeStamp}} if authors
-must always be able to compare timestamps,
+When representing date-times on the platform, use the {{DOMHighResTimeStamp}} type.
+{{DOMHighResTimeStamp}} allows comparison of timestamps,
 regardless of the user's time settings.
 
+{{DOMHighResTimeStamp}} values represent
+a time value in milliseconds.
+See [[!HIGHRES-TIME]] for more details.
+
 Don't use the JavaScript {{Date}} class for representing
 specific date-time values.
 {{Date}} objects are mutable (may have their value changed),
@@ -2126,23 +2129,6 @@ and there is no way to make them immutable.
         on the Web IDL Bugzilla
 </div>
 
-{{DOMTimeStamp}} values represent
-the number of milliseconds since 1970-01-01T00:00:00Z.
-They are derived from the system's clock,
-which may be changed by the user,
-or automatically for things like time zone updates
-or daylight savings.
-This means that, in practice, a {{DOMTimeStamp}}
-created later in real time
-may have a lower value than a {{DOMTimeStamp}} created earlier.
-Also, if two {{DOMTimeStamp}}s are created within the same millisecond,
-there's no way to know which was created earlier.
-
-So, if a date-time is only used to compare timing of events,
-and not to show a formatted date-time value to the user,
-consider using {{DOMHighResTimeStamp}} instead.
-See [[!HIGHRES-TIME]] for more details.
-
 <h3 id="error-types">Use Error or DOMException for errors</h3>
 
 Represent errors in web APIs as ECMAScript error objects (e.g., {{Error}})