W3C home > Mailing lists > Public > www-international@w3.org > July to September 2009

RE: Comments on Best Practices for Authoring HTML: RTL scripts

From: Richard Ishida <ishida@w3.org>
Date: Wed, 15 Jul 2009 21:32:56 +0100
To: "'Ms2ger'" <ms2ger@gmail.com>
Cc: <www-international@w3.org>
Message-ID: <01ed01ca058b$70850800$518f1800$@org>
Thanks for this useful feedback.  Notes below...

============
Richard Ishida
Internationalization Lead
W3C (World Wide Web Consortium)

http://www.w3.org/International/
http://rishida.net/




> -----Original Message-----
> From: www-international-request@w3.org [mailto:www-international-
> request@w3.org] On Behalf Of Ms2ger
> Sent: 15 July 2009 18:52
> To: www-international@w3.org
> Subject: Comments on Best Practices for Authoring HTML: RTL scripts
> 
> Dear
> 
> I have a few comments on the /Best Practices for Authoring HTML:
> Handling Right-to-left Scripts/ Working Draft of 14 July 2009. [1]
> 
> BP 1, Examples 6 and 7: I find it unfortunate that the presentational id
> |rightjustified| and class |clearleft| are suggested as "best practice".
> It would be better to suggest picking ids and classes based on the
> meaning of the markup, rather than the (at this time) preferred
> presentation. (See [2] for example.)

I totally agree that semantic names should be chosen for class names whenever possible.  I think this will mean creating more complicated examples, but I will do so.  You're right that the over-simplistic examples currently used are not good.

> 
> BP 3, Example 8:
> 
> > <html dir="rtl" lang="ar" xmlns="http://www.w3.org/1999/xhtml">
> 
> As this looks like an XHTML document, I believe the attribute
> |xml:lang=""| would be more appropriate.

Ah, thanks for drawing my attention to that.  I converted the visible example text to HTML from the original XHTML before publishing, and I forgot to remove the xmlns in this example.  I'll remove it.

> 
> BP 6, Example 9:
> 
> > <blockquote dir="ltr" lang="en" cite="Romeo and Juliet (II, ii, 1-2)">But,
> soft! What light through yonder window breaks? It is the east, and Juliet is the
> sun.</blockquote>
> 
> This snippet is incorrect HTML for two reasons: it uses |cite=""|
> incorrectly—the value should be a URI, and the contents of a
> /block/quote must be blocks. A more correct version would be
> 
> > <blockquote dir="ltr" lang="en"><p>But, soft! What light through yonder
> window breaks? It is the east, and Juliet is the sun.</p></blockquote>
> 

You're right.  I'll change it.



> Hoping these comments will help to improve the draft

Very useful.  Thanks!

RI


> Ms2ger
> 
> [1] <http://www.w3.org/TR/2009/WD-i18n-html-tech-bidi-20090714/>
> [2] <http://www.w3.org/QA/Tips/goodclassnames>
Received on Wednesday, 15 July 2009 20:33:08 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 15 July 2009 20:33:09 GMT