W3C home > Mailing lists > Public > public-i18n-its@w3.org > January to March 2007

Best Practices - AI about layout

From: Yves Savourel <ysavourel@translate.com>
Date: Sun, 25 Mar 2007 07:01:20 -0600
To: <public-i18n-its@w3.org>
Message-ID: <007301c76edd$af7a63d0$5332a8c0@BREIZH>

Hi everyone,

I had the action item: "Yves to try a restructering of existing examples and how to put highlights and find a pattern".

Looking at the sections we currently have it seems that one of the pattern that would make sense is the following:

- The title of the section

- The short description of the guideline (in the blue rectangle)

- A "How to do this" part where we describe how to implement the guideline, with examples if needed.

- A "Why doing this" part where we give more details

- An optional "Legacy data" part with details on how the BP applies to existing schemas/DTDs.

- The resources part

Maybe the "Legacy data" part should be after or part of the "How to do this" part since it is after all implementation-related
rather than explanations. Or the "How to do this" part should be broken down into different options: the recommended one, then the
fallbacks.

I've changed some of the BPs to match that structure, see for example:

- http://www.w3.org/International/its/techniques/its-techniques.html#DevLang
- http://www.w3.org/International/its/techniques/its-techniques.html#AuthLang


Cheers,
-yves
 
Received on Sunday, 25 March 2007 13:01:22 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:12:48 GMT