Comments for PR-smil20-20010605

These are minor comments for the SMIL 2.0 Proposed Recommendation [1].
Overall it looks beautiful and reads easily.

Somewhere in the introduction, you could place SMIL 2.0 in perspective.
You might explain when SMIL 1.0 was written, and link to [SMIL10].

In 1.1 in design goals, could it be said that your audience is not only
authors but also language designers and people building user agents?

"i18n" could be spelled out once before it is used in 13.3.3.

I don't understand the key word markup sometimes. For example, in
3.7.1, keyTimes and keySplines are sometimes gray, sometimes not.
Looking through chapter 3 will show other examples, like values.
Chapter 4 on the other hand looks perfect.

It would help to decide when "module" is lowercase and when it is
capitalized, and use that throughout. I may have missed a pattern; caps
seem to appear mainly in module names. Same for "host language,"
"language profile," and "integration set."

Globally, "SMIL language" is redundant as the last "L" stands for
"Language."

In 10.6 there is no need to duplicate material from this chapter. The
section on pruning is repeated verbatim from 10.3.3; cutting one or the
other occurrence would save 1.5k. There may be other examples I missed.

Often the closing anchor (</a>) comes one white space after its
contents. When links are underlined, the space after the content is
eclipsed by an underline. Closing up the anchors would fix this. An
example from 10.3.3: <span class="ainst-end ainst">end </span></a>

The BNF for clock-value in PrefetchControl [1] and clipBegin in
MediaClipping [2] could match, by using either "2DIGIT; range from 00
to 59" or "Digit Digit". (The former seems more precise.)

[1] http://www.w3.org/TR/2001/PR-smil20-20010605/smil-content.html#q35
[2] 
http://www.w3.org/TR/2001/PR-smil20-20010605/extended-media-object.html#media-MediaClipping-attributes

Use the same markup for informative/normative in each chapter.
Chapter 5 has: <B><I>This section is informative.</I></B>
Chapter 10 has: <em>This section is informative</em> (preferred)

In chapter 10, /Images/Strip1.gif is 564x271 pixels really, but the
markup says width="578" height="280" resulting in distortion.
/Images/Strip2.gif is 564x270 marked up as width="578" height="279"
(same problem). In 11.1.3 figure 1, the markup says width="350"
height="290" but the image /Images/acceldecel.gif is 349x276 and this
is distorted and cut off.

[1] http://www.w3.org/TR/2001/PR-smil20-20010605/

Best wishes,
-- 
Susan Lesch - mailto:lesch@w3.org  tel:+1.858.483.4819
World Wide Web Consortium (W3C) - http://www.w3.org/

Received on Thursday, 5 July 2001 18:07:04 UTC