[csswg-drafts] [web-animations-1] Distinction between document timelines and timelines associated with a document (#11458)

cdoublev has just created a new issue for https://github.com/w3c/csswg-drafts:

== [web-animations-1] Distinction between document timelines and timelines associated with a document ==
The current [text](https://drafts.csswg.org/web-animations-1/#timeline-associated-with-a-document) (sectioning and wording) seems to suggest that other types of timelines than *document timelines* can be *associated with a document*:

  > **4.3 Timelines**
  >
  > [...]
  >
  > A timeline can be **associated with a document**.
  >
  > **4.3.1 Document timelines**
  >
  > A **document timeline** is a type of timeline associated with a document and whose current time is calculated [...] each time the update animations and send events procedure is run.

But I cannot find any exemple of this.

(1) I would say that any timeline associated with a document *should be* a document timeline, like the potential subclass mentioned in #5420. If I am correct, I think it would be more appropriate to remove the first paragraph above and move the definition of *associated with a document* in the next sub-section.

(2) Relatedly, I cannot find where a document timeline is not associated with a document, so I do not see the point of defining *associated with a document*. If it cannot happen and I am correct in (1), I think it would be clearer to replace *associated with a document* with *document timeline* in the procedures checking this condition.

Please view or discuss this issue at https://github.com/w3c/csswg-drafts/issues/11458 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Wednesday, 8 January 2025 07:32:07 UTC