W3C home > Mailing lists > Public > public-css-bugzilla@w3.org > February 2012

[Bug 16123] New: Cleanup style and markup of spec

From: <bugzilla@jessica.w3.org>
Date: Sun, 26 Feb 2012 05:33:42 +0000
To: public-css-bugzilla@w3.org
Message-ID: <bug-16123-5148@http.www.w3.org/Bugs/Public/>
https://www.w3.org/Bugs/Public/show_bug.cgi?id=16123

           Summary: Cleanup style and markup of spec
           Product: CSS
           Version: unspecified
          Platform: PC
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Transforms
        AssignedTo: smfr@me.com
        ReportedBy: dschulze@adobe.com
         QAContact: public-css-bugzilla@w3.org
                CC: cmarrin@apple.com, eoconnor@apple.com, dino@apple.com,
                    dschulze@adobe.com


We should cleanup the markup of

* Some properties are surrounded by "'" others not:
<code class="property">propery-name</code>
<code class="property">'propery-name'</code>

Should be the same notation in the whole spec. How do we notate attribute
names?

Should we always link to the section of the property if we use it?
<a href="#property-name"><code class="property">property-name</code></a>

* Same values of properties use the same notation as the property itself, but
mostly surrounded by "'" sometimes without "'"
<code class="property">'overflow'</code>

But there are also examples like 'none' without extra markup or

<code style="css">'preserve-3d'</code>

How should values for attributes get marked?

* All headlines use "transformation function", while the text always usees
"transform function". Can we harmonize the naming?

* Referencing terms: Should we reference the description of a term the first
time we use it in the text or always? Like 'transformable element'
I found examples where terms were not linked to the description but are still
italic.

* When do we use class 'css'? I found one example with
<code class="css">perspective(&lt;length&gt;)</code>
I expect that we use it on examples of the syntax?

* For some examples the CSS code is intended after the <style> tag, for others
it is not. Do we always want to intend CSS source?

* Usage of <var>

Sometimes we have something like <var><length></var>, sometimes just
&lt;length&gt; sometimes <i>&lt;length&gt;</i> and sometimes <em><tx></em> When
should we use which notation?

-- 
Configure bugmail: https://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
Received on Sunday, 26 February 2012 05:33:44 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 26 February 2012 05:33:45 GMT