Update animation property documentation for clarity

[estelle]

Clarified the specification of the animation property, detailing the components and their order. Updated notes on animation-timeline and animation-fill-mode behavior.

animation-range-start and animation-range-end were listed as part of the shorthand, but they aren't, and they aren't reset by the shorthan.

[github-actions]

Preview URLs (1 page)

• /en-US/docs/Web/CSS/Reference/Properties/animation

Flaws (1)

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/CSS/Reference/Properties/animation
Title: animation
Flaw count: 1

• broken_links:
  • Link /en-US/docs/Web/CSS/Reference/Values/number-token doesn't resolve

(comment last updated: 2026-04-13 17:16:49)

[chrisdavidmills]

@estelle looking much improved, nice work. I've got some comments for you.

[chrisdavidmills]

You should check the type names in the spec to make sure they match with the ones stated here. For example, <keyframes-name> now seems to be used in place of <single-animation-name>.

[estelle]

matched the formal syntax

[chrisdavidmills]

The formal syntax says <keyframes-name>, and this uses <single-animation-name>?

[chrisdavidmills]

@estelle I reckon this is just about ready to merge now. I added one comment about the Datatypes under values still not matching the formal syntax, but I'm not sure how important that really is. I'll let you consider that one again, and then merge when you are done.