Delete DOMTimestamp and EpochTimestamp

[teoli2003]

These are not real interfaces but a kind of WebIDL-only typedef. We wanted to remove them for a long time.

This PR adapts all occurrences of DOMTimestamp and EpochTimestamp.

This is part of the cleaning needed for having the whole of Web/API covered with page-type: YAML headers. (See #16255)

[github-actions]

Preview URLs (17 pages)

• /en-US/docs/Glossary/Unix_time
• /en-US/docs/Mozilla/Firefox/Releases/23
• /en-US/docs/Mozilla/Firefox/Releases/54
• /en-US/docs/Web/API/CookieChangeEvent/changed
• /en-US/docs/Web/API/CookieChangeEvent/deleted
• /en-US/docs/Web/API/CookieStore/get
• /en-US/docs/Web/API/CookieStore/set
• /en-US/docs/Web/API/Document_Object_Model
• /en-US/docs/Web/API/ExtendableCookieChangeEvent/changed
• /en-US/docs/Web/API/ExtendableCookieChangeEvent/deleted
• /en-US/docs/Web/API/GeolocationCoordinates/longitude
• /en-US/docs/Web/API/GeolocationPosition/timestamp
• /en-US/docs/Web/API/GeolocationPosition
• /en-US/docs/Web/API/Geolocation_API/Using_the_Geolocation_API
• /en-US/docs/Web/API/Notification/timestamp
• /en-US/docs/Web/API/RTCPeerConnection/generateCertificate
• /en-US/docs/Web/API/ServiceWorkerRegistration/showNotification

Flaws (53)

Note! 11 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/Document_Object_Model
Title: Document Object Model (DOM)
Flaw count: 45

• macros:
  • /en-US/docs/Web/API/NodeFilter redirects to /en-US/docs/Web/API/Document/createNodeIterator
  • /en-US/docs/Web/API/SVGFilterPrimitiveStandardAttributes does not exist
  • /en-US/docs/Web/API/SVGHatchElement does not exist
  • /en-US/docs/Web/API/SVGHatchpathElement does not exist
  • /en-US/docs/Web/API/SVGColor does not exist
  • and 40 more flaws omitted

---

URL: /en-US/docs/Web/API/RTCPeerConnection/generateCertificate
Title: RTCPeerConnection.generateCertificate() static function
Flaw count: 4

• macros:
  • /en-US/docs/Web/API/AlgorithmIdentifier does not exist
  • /en-US/docs/Web/API/Algorithm does not exist
  • /en-US/docs/Web/API/RTCCertificateExpiration does not exist
  • /en-US/docs/Web/API/Algorithm does not exist

---

URL: /en-US/docs/Web/API/CookieStore/set
Title: CookieStore.set()
Flaw count: 1

• macros:
  • /en-US/docs/Glossary/serialize redirects to /en-US/docs/Glossary/Serialization

---

URL: /en-US/docs/Web/API/Geolocation_API/Using_the_Geolocation_API
Title: Using the Geolocation API
Flaw count: 1

• macros:
  • The fourth to sixth parameters of 'EmbedLiveSample' are deprecated

---

URL: /en-US/docs/Mozilla/Firefox/Releases/54
Title: Firefox 54 for developers
Flaw count: 1

• macros:
  • /en-US/docs/Web/API/WorkerGlobalScope/close redirects to /en-US/docs/Web/API/DedicatedWorkerGlobalScope/close

---

URL: /en-US/docs/Mozilla/Firefox/Releases/23
Title: Firefox 23 for developers
Flaw count: 1

• macros:
  • /en-US/docs/Web/API/HTMLMediaElement/initialTime does not exist

External URLs (2)

URL: /en-US/docs/Glossary/Unix_time
Title: Unix time

• https://en.wikipedia.org/wiki/Leap_second (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/Unix_time (1 time) (Note! This may be a new URL 👀)

(this comment was updated 2022-11-15 01:08:40.831579)

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[hamishwillee]

@teoli2003 This needs a rebase and remaining fixes. Would be great to get in.

[wbamberg]

@hamishwillee , I think @Elchi3 and I are going to have to take care of this anyway as part of the work on the Performance API: openwebdocs/project#62.

[Elchi3]

Many typedefs probably need no page in the Web/API/ reference. Some (like these two) probably need a glossary page or some docs somewhere. It would be nice to have a plan about typedefs generally. I opened a discussion: mdn/mdn-community#282

[hamishwillee]

@wbamberg Re https://github.com/orgs/mdn/discussions/282#discussioncomment-4141217

other specs - it is generally a unix epoch timestamp, but it doesn't have to be.

This I don't understand though, I thought DOMTimeStamp was replaced with EpochTimeStamp (according to https://developer.mozilla.org/en-US/docs/Web/API/DOMTimeStamp, and also features like https://developer.mozilla.org/en-US/docs/Web/API/Notification/timestamp, which we document as using DOMTimeStamp, but the spec uses EpochTimeStamp: https://notifications.spec.whatwg.org/#timestamp).

See the note in DOMTimeStamp:

So yes, it has been removed and renamed in one spec, but it still gets reference in others. Lazy Hamish says it probably doesn't matter all that much - ie. those other specs are not all that important. But I have not done the investigation.

[wbamberg]

I've fixed the merge conflicts here and made the changes I recommended in my own review :). So this PR now does three things:

• adds a new glossary entry "Unix time"
• deletes the pages for DOMTimeStamp and EpochTimeStamp, and made them redirect to the glossary entry
• changes all links to DOMTimeStamp and EpochTimeStamp to links to the glossary entry

After this there are no references to DOMTimeStamp or EpochTimeStamp on MDN.

This doesn't yet tackle DOMHighResTimeStamp - I think that does not belong in a "Unix time" glossary entry, but in a bit of guide material for the Perf APIs, and it will be cleaner to do it in a different PR. When we do that, we should update the glossary entry to point lost people at this new guide material, like "if you are looking for high-res (sub-millisecond) timestamps used in the perf APIs, see XYZ".

I added my own recommendations!

[hamishwillee]

Perhaps not relevant to this change, but does it matter that it is double-precision floating point? Isn't it just a number in JavaScript

[hamishwillee]

Excellent. Just a couple of comments. If you either respond or mark those resolved I am happy to merge (or for you to).

[wbamberg]

I thought "the time at which a notification is actual." was a typo but it is a quote from the spec: https://notifications.spec.whatwg.org/#timestamp. Maybe we should keep it? I don't love "associated with" either.

[hamishwillee]

FWIW I am OK with this and would have complained about "actual".