This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 16123 - Cleanup style and markup of spec
Summary: Cleanup style and markup of spec
Status: RESOLVED FIXED
Alias: None
Product: CSS
Classification: Unclassified
Component: Transforms (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Simon Fraser
QA Contact: public-css-bugzilla
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-02-26 05:33 UTC by Dirk Schulze
Modified: 2012-02-26 17:33 UTC (History)
6 users (show)

See Also:


Attachments

Description Dirk Schulze 2012-02-26 05:33:41 UTC
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?
Comment 1 Dirk Schulze 2012-02-26 17:33:57 UTC
Fixed most of the style issues and harmonized the document with the style of CSS3 Background and CSS3 Images. Fixed some typos.

Commit: 2012/02/26.

No functional changes.