W3C home > Mailing lists > Public > public-webplatform@w3.org > August 2014

Re: Depreciated Presentation Attributes.

From: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com>
Date: Sat, 9 Aug 2014 09:08:11 -0600
Message-ID: <CAFDDJ7ygGez8W+vRJBj+Utdu5szoVm4qUOG6noX0ckGa362oPw@mail.gmail.com>
To: "Rob^_^" <iecustomizer@hotmail.com>
Cc: List WebPlatform public <public-webplatform@w3.org>
(see below)

On 8 August 2014 22:55, Rob^_^ <iecustomizer@hotmail.com> wrote:
>
> for depreciated presentational attributes (align, cellspacing,
> cellpadding, valign, halign, bkcolor, etc), should there be a big.
>
> “*Depreciated: Use CSS instead* “
>
> warning?
>
>

I don't know about "big", but this information should be clearly indicated
in multiple places:

   - the summary should clearly mention that the element/attribute is
   deprecated,
   - the Standardization Status field should be set to deprecated, and
   - the main description should explain why it is deprecated and what
   authors should use instead.

(P.S., Note that the standard term in W3 is "deprecated", not
"depreciated", see http://www.w3.org/TR/html4/conform.html )

For the summary, I'm not sure which style is preferred (existing summaries
use all these styles) :

Deprecated.  The <code>align</code> attribute  sets the horizontal
alignment of text in a table.


The deprecated <code>align</code> attribute sets the horizontal alignment
of text in a table.

The <code>align</code> attribute sets the horizontal alignment of text in a
table. Its use is deprecated as of HTML 4.

I.e., Whether to have the word up-front as it's own statement (the way we
mark read-only properties), whether it should be part of the sentence
describing the item, or whether it should be an extra sentence at the end.

This might be a good time to decide on a standard style that we can include
in the style guide.  (I've been meaning to add a paragraph to the style
guide about summaries, anyway...)

Anyone have an opinion on which to use?

AmeliaBR

P.S.  Sorry if you all got an empty email from me...  As if I don't already
send *enough* emails to this list!
Received on Saturday, 9 August 2014 15:08:39 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:21:03 UTC