- From: Martin Duerst <duerst@it.aoyama.ac.jp>
- Date: Sat, 17 Feb 2007 16:01:05 +0900
- To: "Richard Ishida" <ishida@w3.org>, "'GEO'" <public-i18n-geo@w3.org>
- Cc: <public-i18n-core@w3.org>
Hello Richard, I think using questions is a neat idea, but as you say, it doesn't really work that well. Also, I don't think WAI is using questions, and it's good to have a similar style. As for details, I'm not sure why there is a change of escaping syntax in: >[2] >Escapes. Only use escapes (e.g.     or ) in specific >circumstances. >>> >Escapes. Use characters rather than escapes (e.g. &#xA0; &#160; or >&nbsp;) whenever you can. I'd assume the first was taken from the visible page, and the second copied from the source, yes? Regards, Martin. At 22:05 07/02/14, Richard Ishida wrote: > >Chaps, > >We are running low on quick tips cards, but will be able to print more. >Before doing so, however, I'd like to improve on some of the text. > > >Here is the current text (see the format at >http://www.w3.org/International/quicktips/quicktips.pdf ): > >=================== > >W3C Internationalization Quick Tips for the Web > >More at http://www.w3.org/International/quicktips/ > >Encoding. Use Unicode wherever possible for content, databases, etc. Always >declare the encoding of content. > >Escapes. Only use escapes (e.g.     or ) in specific >circumstances. > >Language. Declare the text-processing language of documents and indicate >any internal language changes. > >Presentation vs. content. Use style sheets for presentational information. >Restrict markup to semantics. > >Images, animations & examples. Check for translatability and inappropriate >cultural bias. > >Forms. Use an appropriate encoding on both form and server. Support local >formats of names/addresses, times/dates, etc. > >Text authoring. Use simple, concise text. Do not compose sentences from >multiple strings using scripting. > >Navigation. On each page include clearly visible navigation to localized >pages or sites. Use the target language. > >Right-to-left text. For XHTML, add dir="rtl" to the html tag. Only re-use >it to change directionality. > >Check your work. Validate! Use techniques, tutorials, and articles at >http://www.w3.org/International/ > >========================= > > >APPROACH 1: MINIMAL TWEAKS > >I propose the following changes: > >[1] >More at http://www.w3.org/International/quicktips/ >>> >Details at http://www.w3.org/International/quicktips/ > > >[2] >Escapes. Only use escapes (e.g.     or ) in specific >circumstances. >>> >Escapes. Use characters rather than escapes (e.g. &#xA0; &#160; or >&nbsp;) whenever you can. > >[3] >Text authoring. Use simple, concise text. Do not compose sentences from >multiple strings using scripting. >>> >Text authoring. Use simple, concise text. Use care when composing sentences >from multiple strings. > >[4] >Navigation. On each page include clearly visible navigation to localized >pages or sites. Use the target language. >>> >Navigation. On each page include clearly visible navigation to localized >pages or sites, using the target language. > >[5] >Check your work. Validate! Use techniques, tutorials, and articles at >http://www.w3.org/International/ >>> >Check your work. Validate! Use best practises, tutorials, and articles at >http://www.w3.org/International/ > > > > > > >APPROACH 2: REWRITE USING QUESTIONS > > >Encoding. Use Unicode wherever possible for content, databases, etc. Always >declare the encoding of content. >>> >Encoding. Did you use Unicode? Did you declare the character encoding of >your content? > > >Escapes. Only use escapes (e.g.     or ) in specific >circumstances. >>> >Escapes. Did you avoid using escapes (e.g.     or ) >whenever possible? > > >Language. Declare the text-processing language of documents and indicate >any internal language changes. >>> >Language. Did you declare the language of the text, and indicate any >internal language changes? > > > >Presentation vs. content. Use style sheets for presentational information. >Restrict markup to semantics. >>> >Presentation vs. content. Are you using style sheets for presentational >information, and restricting markup to semantics? > > >Images, animations & examples. Check for translatability and inappropriate >cultural bias. >>> >Images, animations & examples. Have you checked for translatability and >inappropriate cultural bias? > > >Forms. Use an appropriate encoding on both form and server. Support local >formats of names/addresses, times/dates, etc. >>> >Forms. Are encodings compatible on both form and server? Do you support >local formats for names/addresses, times/dates, etc? > > >Text authoring. Use simple, concise text. Do not compose sentences from >multiple strings using scripting. >>> >Text authoring. Do you use simple, concise text? Are there issues due to >composing sentences from multiple strings? > > >Navigation. On each page include clearly visible navigation to localized >pages or sites. Use the target language. >>> >Navigation. Does each page include clearly visible navigation to localized >pages or sites, and use the target language? > > >Right-to-left text. For XHTML, add dir="rtl" to the html tag. Only re-use >it to change directionality. >>> >Right-to-left text. Did you add dir="rtl" to the html tag, and only re-use >it to change directionality? > > >Check your work. Validate! Use techniques, tutorials, and articles at >http://www.w3.org/International/ >>> >Check your work. Does it validate? Did you check out best practises, >tutorials, and articles at http://www.w3.org/International/? > > > >Some parts seem to work as questions, but I'm not absolutely convinced that >it's a good change throughout - plus these become no longer 'quick tips', >more like 'quick checklist'. > >Thoughts please. > >RI > > > >============ >Richard Ishida >Internationalization Lead >W3C (World Wide Web Consortium) > >http://www.w3.org/People/Ishida/ >http://www.w3.org/International/ >http://people.w3.org/rishida/blog/ >http://www.flickr.com/photos/ishida/ > > >-- >No virus found in this outgoing message. >Checked by AVG Free Edition. >Version: 7.5.441 / Virus Database: 268.17.39/685 - Release Date: 13/02/2007 22:01 > #-#-# Martin J. Du"rst, Assoc. Professor, Aoyama Gakuin University #-#-# http://www.sw.it.aoyama.ac.jp mailto:duerst@it.aoyama.ac.jp
Received on Sunday, 18 February 2007 23:18:39 UTC