- From: Susan Lesch <lesch@w3.org>
- Date: Thu, 5 Jul 2001 15:07:00 -0700
- To: www-smil@w3.org
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