- From: <bugzilla@jessica.w3.org>
- Date: Sun, 26 Feb 2012 05:33:42 +0000
- To: public-css-bugzilla@w3.org
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(<length>)</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
<length> sometimes <i><length></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 UTC