Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor DocumentTimeline's discussion of time origin #24011

Merged
merged 13 commits into from
Feb 10, 2023

Conversation

ninevra
Copy link
Contributor

@ninevra ninevra commented Jan 31, 2023

Description

Replace references to navigationStart with timeOrigin. Move discussion of "origin time" from Document.timeline to DocumentTimeline(). Specify the default originTime in DocumentTimline(). Add examples showing how originTime works. Define "non-active document".

Motivation

Clarity, completeness.

navigationStart is marked obsolete, doesn't match the terminology in the standard, and isn't terribly relevant to animation in any case.

The "origin time" discussion is redundant in Document.timeline because that timeline's origin time is always zero, and therefore not terribly observable.

"Origin time" and "time origin" are both confusing and easily confused (w3c/csswg-drafts#2079); hopefully examples help with that a bit.

Refer and link to "time origin" rather than the deprecated
"navigationStart".

Remove discussion of the "origin time" as it is always 0. A better
place to discuss it would be `new DocumentTimeline()`, where it is
configurable.
Refer to "time origin" rather than "navigationStart".

Specify default value of "originTime" option.
@ninevra ninevra requested a review from a team as a code owner January 31, 2023 05:19
@ninevra ninevra requested review from jpmedley and removed request for a team January 31, 2023 05:19
@github-actions github-actions bot added the Content:WebAPI Web API docs label Jan 31, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Jan 31, 2023

Preview URLs

(comment last updated: 2023-02-07 23:45:20)

Copy link
Collaborator

@jpmedley jpmedley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your help. I have a few questions.

@ninevra
Copy link
Contributor Author

ninevra commented Feb 1, 2023

Added missing {{optional_inline}} annotations.

@ninevra ninevra requested a review from jpmedley February 1, 2023 04:35
@jpmedley jpmedley merged commit d1caac0 into mdn:main Feb 10, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:WebAPI Web API docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants