Best Practices - AI about layout

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 UTC