16123 2012-02-26 05:33:41 +0000 Cleanup style and markup of spec 2012-02-26 17:33:57 +0000 1 1 1 Unclassified CSS Transforms unspecified PC All RESOLVED FIXED P2 normal --- 1 dschulze smfr ayg cmarrin dino dschulze eoconnor vhardy public-css-bugzilla oldest_to_newest 64603 0 dschulze 2012-02-26 05:33:41 +0000 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? 64622 1 dschulze 2012-02-26 17:33:57 +0000 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.