Skip to content

Commit fe175c5

Browse files
committed
[css-text-3] Start notes with "Note:"
Prior to this change, some notes started with "Note:", some started with "Note that", and some started without any mention of it being a note. This just makes everything consistent, so that all notes can be readily identified. I chose the "Note:" for over the "Note that" form as it makes it less likely that we'll break something in a later update to the spec to use less HTML and more bikeshed-flavored markdown, since bikeshed turns "Note:" into notes even in the absence of class=note. Closes #3211
1 parent dfa85aa commit fe175c5

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

css-text-3/Overview.bs

+20-20
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ Introduction</h2>
9898
and <a href="#edge-effects">indentation</a>.
9999

100100
<div class="note">
101-
<p>Font selection is covered in <a href="https://www.w3.org/TR/css-fonts-3/">CSS Fonts Level 3</a> [[CSS-FONTS-3]].
101+
<p>Note: Font selection is covered in <a href="https://www.w3.org/TR/css-fonts-3/">CSS Fonts Level 3</a> [[CSS-FONTS-3]].
102102

103103
<p>
104104
<span id="decoration"></span>
@@ -254,7 +254,7 @@ Characters and Letters</h3>
254254
depending on the operation as needed.
255255

256256
<p class="note">
257-
The rules for such tailorings are out of scope for CSS.
257+
Note: The rules for such tailorings are out of scope for CSS.
258258
<!--
259259
however W3C currently maintains a wiki page
260260
where some known tailorings are collected.
@@ -373,7 +373,7 @@ Characters and Letters</h3>
373373
</div>
374374

375375
<p class="note">
376-
Note that, as defined in <a href="#order">Text Processing Order of Operations</a>,
376+
Note: As defined in <a href="#order">Text Processing Order of Operations</a>,
377377
transforming text affects line-breaking and other formatting operations.
378378

379379
<p>
@@ -429,7 +429,7 @@ Characters and Letters</h3>
429429
U+0020 spaces to U+3000 within <a>preserved</a> white space.
430430

431431
<p class="note">
432-
A future level of CSS may introduce the ability to create custom mapping
432+
Note: A future level of CSS may introduce the ability to create custom mapping
433433
tables for less common text transforms, such as by an ''@text-transform''
434434
rule similar to ''@counter-style'' from [[CSS-COUNTER-STYLES-3]].
435435

@@ -491,7 +491,7 @@ Characters and Letters</h3>
491491
As preserved spaces take up space and do not hang,
492492
they affect the box's intrinsic sizes ([=min-content size=] and [=max-content size=]).
493493

494-
<p class="note">This value does not guarantee that there will never be any overflow due to spaces:
494+
<p class="note">Note: This value does not guarantee that there will never be any overflow due to spaces:
495495
for example, if the line length is so short that even a single space does not fit,
496496
overflow is unavoidable.</p>
497497
<dt><dfn>pre-line</dfn></dt>
@@ -599,7 +599,7 @@ Characters and Letters</h3>
599599
in the text is treated as a <dfn export>segment break</dfn>,
600600
which is then interpreted for rendering as specified by the 'white-space' property.
601601

602-
<p class="note">Note that a document parser might
602+
<p class="note">Note: A document parser might
603603
not only normalize any <a>segment breaks</a>,
604604
but also collapse other space characters or
605605
otherwise process white space according to markup rules.
@@ -609,7 +609,7 @@ Characters and Letters</h3>
609609
can be affected by these limitations and
610610
may be user agent dependent.</p>
611611

612-
<p class="note">Note that anonymous blocks consisting entirely of
612+
<p class="note">Note: Anonymous blocks consisting entirely of
613613
<a>collapsible</a> <a>white space</a> are removed from the rendering tree.
614614
Thus any such <a>white space</a> surrounding a block-level element is collapsed away.
615615
See [[CSS2]] section
@@ -640,7 +640,7 @@ Characters and Letters</h3>
640640
spaces (U+0020), tabs (U+0009), and <a href="#white-space-processing">segment breaks</a>.
641641

642642
<p class="note">
643-
Note that the set of characters considered <a>document white space</a> (part of the document content)
643+
Note: The set of characters considered <a>document white space</a> (part of the document content)
644644
and that considered syntactic white space (part of the CSS syntax)
645645
are not necessarily identical.
646646
However, since both include spaces (U+0020), tabs (U+0009), and line feeds (U+000A)
@@ -755,7 +755,7 @@ Characters and Letters</h3>
755755
<li>Otherwise, the segment break is converted to a space (U+0020).
756756
</ul>
757757

758-
<p class="note">Note that the white space processing rules have already
758+
<p class="note">Note: The white space processing rules have already
759759
removed any tabs and spaces after the segment break before these checks
760760
take place.</p>
761761

@@ -878,7 +878,7 @@ Characters and Letters</h3>
878878
however some controls are provided to distinguish common variations.
879879

880880
<div class="note">
881-
<p>Further information on line breaking conventions can be found in
881+
<p>Note: Further information on line breaking conventions can be found in
882882
[[JLREQ]] and [[JIS4051]] for Japanese,
883883
[[ZHMARK]] for Chinese, and
884884
in [[!UAX14]] for all scripts in Unicode.
@@ -975,7 +975,7 @@ Line Breaking Details</h3>
975975
</div>
976976

977977
<p class="note">
978-
To enable additional break opportunities only in the case of overflow,
978+
Note: To enable additional break opportunities only in the case of overflow,
979979
see 'overflow-wrap'.
980980

981981
<p>Values have the following meanings:</p>
@@ -1015,7 +1015,7 @@ Line Breaking Details</h3>
10151015
except where opportunities exist due to dictionary-based breaking.
10161016
Otherwise this option is equivalent to ''word-break/normal''.
10171017
In this style, sequences of CJK characters do not break.
1018-
<p class=note>This is the other common behavior for Korean (which uses spaces between words),
1018+
<p class=note>Note: This is the other common behavior for Korean (which uses spaces between words),
10191019
and is also useful for mixed-script text where CJK snippets are mixed
10201020
into another language that uses spaces for separation.</dd>
10211021
</dl>
@@ -1221,7 +1221,7 @@ Line Breaking Details</h3>
12211221
</ul>
12221222
</ul>
12231223

1224-
<p class="note">In the requirements listed above,
1224+
<p class="note">Note: In the requirements listed above,
12251225
no distinction is made among the levels of strictness in non-CJK text:
12261226
only CJK codepoints are affected,
12271227
unless the text is marked as Chinese or Japanese,
@@ -1240,7 +1240,7 @@ Line Breaking Details</h3>
12401240
(ตัวอย่าง·การ·เขียน·ภาษา·ไทย).
12411241
</div>
12421242

1243-
<p class="note">The CSSWG recognizes that in a future edition of the
1243+
<p class="note">Note: The CSSWG recognizes that in a future edition of the
12441244
specification finer control over line breaking may be necessary to
12451245
satisfy high-end publishing requirements.
12461246

@@ -1632,7 +1632,7 @@ Shaping Across Intra-word Breaks</h3>
16321632
src="images/text-justify-none.png"></p>
16331633
<p class="caption">Mixed-script text with ''text-justify: none''
16341634
</div>
1635-
<p class="note">This value is intended for use in user stylesheets
1635+
<p class="note">Note: This value is intended for use in user stylesheets
16361636
to improve readability or for accessibility purposes.
16371637

16381638
<dt><dfn>inter-word</dfn></dt>
@@ -2089,7 +2089,7 @@ Cursive Scripts</h4>
20892089
</table>
20902090
</div>
20912091
<div class="note">
2092-
Note that proper cursive elongation or compression of a text
2092+
Note: Proper cursive elongation or compression of a text
20932093
can vary depending on the
20942094
script, typeface, language,
20952095
location within a word, location within a line,
@@ -2268,7 +2268,7 @@ Cursive Scripts</h4>
22682268
</pre>
22692269
</div>
22702270

2271-
<p class="note">Note that since the 'text-indent' property inherits,
2271+
<p class="note">Note: Since the 'text-indent' property inherits,
22722272
when specified on a block element, it will affect descendant
22732273
inline-block elements.
22742274
For this reason, it is often wise to specify 'text-indent: 0' on
@@ -2292,7 +2292,7 @@ Cursive Scripts</h4>
22922292
<a>hangs</a> and may be placed outside the line box (or in the indent)
22932293
at the start or at the end of a line of text.
22942294

2295-
<p class="note">Note that if there is not sufficient padding on the
2295+
<p class="note">Note: If there is not sufficient padding on the
22962296
block container, 'hanging-punctuation' can trigger overflow.</p>
22972297

22982298
<p>When a punctuation mark <dfn lt="hang">hangs</dfn>, it is not considered
@@ -2362,7 +2362,7 @@ Cursive Scripts</h4>
23622362
</table>
23632363
<p>The UA may include other characters as appropriate.
23642364

2365-
<p class="note">The CSS Working Group would appreciate if UAs including
2365+
<p class="note">Note: The CSS Working Group would appreciate if UAs including
23662366
other characters would <a href="#status">inform the working group</a>
23672367
of such additions.</p>
23682368

@@ -2432,7 +2432,7 @@ Bidirectionality and Line Boxes</h3>
24322432
&lt;/block&gt;</pre>
24332433
</div>
24342434

2435-
<p class="note">Note that the inline base direction determined here
2435+
<p class="note">Note: The inline base direction determined here
24362436
applies to the line box itself, and not to its contents.
24372437
It affects 'text-align-all', 'text-align-last', 'text-indent', and 'hanging-punctuation',
24382438
i.e. the position and alignment of its contents with respect to its edges.

0 commit comments

Comments
 (0)