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

Re: [css3-fonts] Copyedits Part A

From: John Daggett <jdaggett@mozilla.com>
Date: Mon, 4 Feb 2013 18:46:22 -0800 (PST)
To: www-style@w3.org
Message-ID: <1439145110.349050.1360032382849.JavaMail.root@mozilla.com>
fantasai wrote:

> General Comments
> ----------------
>    One thing I noticed is that you don't use <div class="example"> for examples.
>    It might be a good idea to do that, just to help distinguish normative vs.
>    informative text. Also, in general, be clear when you are using an example
>    by introducing it with "For example,".

I think text wrapped in <div class=example> are for examples that
demonstrate but don't define usage.  Saying that any sentence that
uses "for example" or "e.g." should be wrapped this way seems silly.

I also do think that "for example" text is often closely tied to
definitions of how features work, they attempt to eliminate common
misinterpretations in a normatively defined feature.  In my opinion,
adding "below are examples of invalid usage" amplifies the normative
wording and shouldn't be viewed as informative.

For the other cases, I've taken your suggestion or reworked the text.


John Daggett
Received on Tuesday, 5 February 2013 02:46:50 UTC

This archive was generated by hypermail 2.3.1 : Monday, 2 May 2016 14:39:08 UTC