Skip to content

Revise performance timing entries' names and descriptions - #4278

Draft
ddbeck wants to merge 1 commit into
web-platform-dx:mainfrom
ddbeck:revise-performance-timing-entries-names-and-desc/qvxlnomwrtww
Draft

Revise performance timing entries' names and descriptions#4278
ddbeck wants to merge 1 commit into
web-platform-dx:mainfrom
ddbeck:revise-performance-timing-entries-names-and-desc/qvxlnomwrtww

Conversation

@ddbeck

@ddbeck ddbeck commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

A follow up to #4237.

@github-actions github-actions Bot added the feature definition Creating or defining new features or groups of features. label Aug 27, 2026

@tunetheweb tunetheweb left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Mostly LGTM but if we're capitalising some, then I'd capitalise them all. The specs mostly treat these as proper nouns (though not in all places I've noticed!).

And similarly I'd suggest adding "peformance entries" consistently.

I've also suggested changes to Visibility State and Resource Timing to make them clearer.

@@ -1,5 +1,5 @@
name: Element timing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Element timing
name: Element Timing performance entries

@@ -1,5 +1,5 @@
name: Layout instability

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Layout instability
name: Layout Instability performance entries

@@ -1,5 +1,5 @@
name: Navigation timing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Navigation timing
name: Navigation Timing performance entries

Comment thread features/paint-timing.yml
@@ -1,5 +1,5 @@
name: Paint timing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Paint timing
name: Paint Timing performance entries

@@ -1,5 +1,5 @@
name: Resource timing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Resource timing
name: Resource Timing performance entries

@@ -1,5 +1,5 @@
name: Soft navigation performance entries

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Soft navigation performance entries
name: Soft Navigation performance entries

@@ -1,5 +1,5 @@
name: Resource timing
description: "`PerformanceResourceTiming` entries report when network events happen while loading a resource, such as when connections start and end. You can use this information to measure loading times."
description: A `PerformanceResourceTiming` performance entry records when a network event happens while loading a resource, such as when a connection starts and ends. You can use this information to measure loading times.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
description: A `PerformanceResourceTiming` performance entry records when a network event happens while loading a resource, such as when a connection starts and ends. You can use this information to measure loading times.
description: A `resource` performance entry records network event timings, such as when a connection starts and ends or loading time, for resources requested by a page.

@@ -1,5 +1,5 @@
name: Page visibility state

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
name: Page visibility state
name: Page Visibility State Entry performance entry

I think this is especially important to rename to differentiate it from page-visibility.yml (which is related but different - one just gets the current state, the other monitors for changes).

@tunetheweb tunetheweb mentioned this pull request Aug 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature definition Creating or defining new features or groups of features.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants