- From: Karl Dubost <karl@w3.org>
- Date: Wed, 16 Feb 2005 17:01:03 -0500
- To: 'www-qa-wg@w3.org' <www-qa-wg@w3.org>
- Message-Id: <fed25b09ede8735d4e315cec19d38848@w3.org>
New proposed text after Richard Kennedy Suggestions:
http://www.w3.org/mid/8dfb6f9190b9bb7924786ea04c93659c@boeing.com
====================================
2.2 What needs to conform
2.2 Requirement A: Identify who or/and what will implement the
specification.
====================================
No need to change the prose if we accept the new definition of Class of
Product. See other mail today.
(I have just change the or/and by resolution of ISSUE 1089
http://www.w3.org/Bugs/Public/show_bug.cgi?id=1089)
proposed Text
Abstract of Changes:
title:
“Define how deprecated feature is handled by each class of
product.”
---> “Define how deprecated feature is handled.”
Technique #1:
“Consider the effect of deprecation on all classes of products that
implement the specification (e.g., authoring tools, converter, user
agents).”
---> “Consider the effect of deprecation on all products that implement
the
specification (e.g., authoring tools, converter, user agents).”
===========================
4.4 Requirement B: Define how deprecated feature is handled.
What does it mean?
By deprecating a feature, the Working Group indicates its desire that
the feature disappear from a future version of the specification. The
motivation may be to convert an old feature to a newer one or to remove
an old, dangerous, redundant or undesirable feature. Regardless of the
reason, it is important to define the affect this has on
implementations that may encounter this feature (e.g., consumer
products such as user agents or producer products such as authoring
tools). Will use of the deprecated feature be tolerated? Will it signal
an error or a warning? Typically, it is expected that a deprecated
feature would not affect a consumer (e.g. user agent), while a producer
(e.g. authoring tool) should issue a warning.
Why care?
Defining how deprecated features are handled provides a smoother
transition for the users of the specified technology, and ensure more
consistency of the behavior across implementations. It is also
particularly important for implementations that needs to support
different versions of the specification.
For instance, the specification may require that an implementation
supports both the features of the new and the old specifications, or
suggest a converting mechanism.
Related
• D3. Define error handling for unknown extensions
Techniques
1. Consider the effect of deprecation on all products that implement
the
specification (e.g., authoring tools, converter, user agents).
2. Define how it affects conformance
Examples
In Mathematical Markup Language (MathML) Version 2.0 (Second Edition)
[MATHML20], MathML2.0 section 7.2.1.2 describes deprecated MathML 1.x
features in terms of MathML-output-conformant authoring tools,
MathML-input-conformant rendering/reading tools, and
MathML-roundtrip-conformant processors.
HTML 4.01 [HTML401]: In the conformance section of HTML 4.01, there is
the definition of deprecation and what user agents should do. The
behavior for other kind of products is not defined though.
User agents should continue to support deprecated elements for reasons
of backward compatibility.
======================================
--
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager
*** Be Strict To Be Cool ***
Received on Thursday, 17 February 2005 00:31:48 UTC