Skip to content

Commit 1d2e1f1

Browse files
committed
[web-animations-1] Add introductory text describing how properties are updated
Closes w3c#2359.
1 parent 2fab934 commit 1d2e1f1

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

web-animations-1/Overview.bs

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -386,6 +386,24 @@ and is only relevant to user agents that provide scripting support.
386386

387387
</div>
388388

389+
<h2 id="spec-conventions">Specification conventions</h2>
390+
391+
This specification begins by describing abstract concepts such as [=animations=]
392+
and [=animation effects=] and properties that belong to them such as their
393+
[=playback rate=] or [=iteration duration=].
394+
In addition to these properties, there are often specific procedures for
395+
updating these properties such as the procedure to [=set the playback rate=] or
396+
the procedure to [=set the start time=] of an animation.
397+
398+
Where this specification does not specifically link to a procedure, text
399+
that requires the user agent to update a property such as, &ldquo;make
400+
|animation|'s [=start time=] [=unresolved=]&rdquo;, should be understood to
401+
refer to updating the property directly <em>without</em> invoking any related
402+
procedure.
403+
404+
Further documentation conventions that are not specific to this specification
405+
are described in [[#conventions]].
406+
389407
<h2 id="web-animations-model-overview">Web Animations model overview</h2>
390408

391409
<div class='informative-bg'><em>This section is non-normative</em>

0 commit comments

Comments
 (0)