W3C home > Mailing lists > Public > www-i18n-comments@w3.org > April 2001

Comments for PR-ruby-20010406

From: Susan Lesch <lesch@w3.org>
Date: Sat, 21 Apr 2001 13:58:57 -0700
Message-Id: <p05010400b707a3f40b7e@[24.25.223.38]>
To: www-i18n-comments@w3.org
Belated congratulations on your Ruby Annotation Proposed Recommendation [1].
These are minor editorial comments, mainly typos I missed earlier.

Globally stylesheet -> style sheet (one way or the other)

In A., the file extension for xhtml-ruby-1.mod is ".mod". Just a note that
even though it is application/xml-dtd, MacIE 5.0 downloaded it as a MOD
music file. Older MacIEs didn't seem to; I don't know why.
(http://www-cs-students.stanford.edu/~franke/SoundApp/formats.html#mod)

There are two appendix Cs.

"B. Notes on design decisions" is missing in the TOC.

In http://www.w3.org/TR/2001/PR-ruby-20010406/style.css:
     .content {
         font-family: monospace;
         color: blue;
         font-weight: bold;
     }
blue is very close to the current W3C TR unvisited link color, #00c.
(see http://www.w3.org/StyleSheets/TR/base.css). Could you use black?

In http://www.w3.org/TR/2001/PR-ruby-20010406/encodings:
For reader's convenience
For readers' convenience (or, For the reader's convenience)

Below, a section and paragraph number is followed by a quote and then
a suggestion.

1. pars. 4 and 5
Ruby
ruby

1.1 second to last par.
"...each ruby annotation may be associated with different, but
     overlapping, parts of the base text..."
How are the parts "overlapping"? They look distinct. Maybe say
"adjacent"? Or maybe this means "different, or overlapping."

3. last par.
formating
formatting

3.1 par. 1
"...section 3.2 (font size), section 3.3 (positioning), and 3.4
     (presentation of ruby markup)..."
"3.4" could be "section 3.4" and link as the other two do (or
maybe you had a reason why 3.4 is not linked).

Helpful as it is, I'm not sure this sentence needs repeating in 3.2
since it is in 1.1.
"...In fact, the name "ruby" originated from the name of the 5.5pt
     font size in British printing, which is about half the 10pt font
     size commonly used for normal text."

3.5 list item 2
Ruby that represent
Ruby that represents

ruby that contain
ruby that contains

3.5 par. 2
detailled (twice)
detailed

3.5 last par.
Hiragana
hiragana

B. par. 2
occurence
occurrence

C. Notes on backwards compatibility par. 2
For historical reason
For historical reasons (or, For a historical reason)

C. Glossary, Complex ruby markup
finegrained
fine-grained (to match the other occurrences)

C. Hiragana and Katakana
character of that script
a character of that script (or, characters of that script)

C. Ideograph
Character that is used
A character that is used

You might consider cutting the change notes if and when you go to
Recommendation.

References, XSL
et. al.
et al.

References, XSLT
Recommenation
Recommendation

[1] http://www.w3.org/TR/2001/PR-ruby-20010406/

Best wishes for your project,

-- 
Susan Lesch - mailto:lesch@w3.org  tel:+1.858.483.4819
World Wide Web Consortium (W3C) - http://www.w3.org/
Received on Saturday, 21 April 2001 16:59:03 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 27 October 2009 08:32:27 GMT