W3C home > Mailing lists > Public > www-style@w3.org > November 2013

Re: [css-counter-styles] 'speak-as' comments

From: Tab Atkins Jr. <jackalmage@gmail.com>
Date: Thu, 7 Nov 2013 11:01:36 -0800
Message-ID: <CAAWBYDB46=YY3Mtoe9C=OP7Ljpur-ycy1Uq=TAnuvdw6bkpXgQ@mail.gmail.com>
To: Brad Kemper <brad.kemper@gmail.com>
Cc: www-style list <www-style@w3.org>
On Thu, Nov 7, 2013 at 9:06 AM, Brad Kemper <brad.kemper@gmail.com> wrote:
> Just a couple thoughts as I was reading about 'speak-as':
>
>        bulletThe UA speaks a UA-defined phrase or audio cue that represents
> a list item being read out.
>
> Should that be 'an unordered list item being read out', to make it more
> clear that this is not talking about an LI of an OL?

Done.

>        <counter-style-name>The counter's value is instead spoken out in the
> specific style. If the specified style does not exist, this value is treated
> as auto.
> It seems like maybe you meant "specified" where you said "specific".

Fixed.

> I think
> the meaning would be more obvious if you said "in the specified
> '@counter-style' name, and then linked to where <counter-style-name> is
> defined in section 3. (Maybe that was what you meant to do for
> <counter-style-name> in the 'speak-as' section, but it is just linking to
> itself.) or just link to section 3.

I've clarified a bit.  I'm not sure what you mean by "linking to
itself" - it definitely links to the definition of the
<counter-style-name> type.

> Also, shouldn't there be something in there to say what happens if
> 'speak-as' is referring to its own counter-style-name? I assume that would
> be the same as auto.

Fixed a bit ago based on other feedback.

> I think it would be nice if there was an example for 'speak-as:
> <counter-style-name>'.

This is exactly what the existing example shows.

~TJ
Received on Thursday, 7 November 2013 19:02:23 UTC

This archive was generated by hypermail 2.4.0 : Friday, 25 March 2022 10:08:36 UTC