On the structure of the techniques document

Hi Diane and Yves, possibly others,

I would like to make a proposal for the structure of the techniques
document: have a very similar structure for each technique. An example
of a document which has such a structure is [1]. It describes the
structure at [2].

I'll give an example how this could work for the language tag technique [3]:

[[[

- Heading: Language specification of content

- Statement: Use the xml:lang attribute to specify in what language is
the content of an element.

- What it means:

Having information about what is the language of a content is very
important in many situation. Some of them are:
  [...]

The normal way of specifying the language of a document is to declare it
in the root element and, if needed, to override that initial declaration
for parts of the document in a different language.

- What to test:
Machine testable: check if the xml:lang attribute is used at least at
the root element.
Human testable: check if an application which is processing language
information is doing the right thing, e.g. language specific styling in
a browser.

- References: Reference to XML.

]]]

Looking forward for feedback.
Cheers,

Felix

[1] http://www.w3.org/TR/2006/WD-mobile-bp-20060113/
[2] http://www.w3.org/TR/2006/WD-mobile-bp-20060113/#iddiv2102373592
[3] http://esw.w3.org/topic/its0601TechLangAuth

Received on Wednesday, 22 February 2006 14:18:50 UTC