[css-font-loading] Fill in intro.

Author: tabatkins

css-font-loading/Overview.bs

@@ -10,14 +10,26 @@ Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
 Former Editor: John Daggett, Mozilla, jdaggett@mozilla.com
 Abstract: This CSS module describes events and interfaces used for dynamically loading font resources.
 Link Defaults: css-fonts-3 (descriptor) src
-Ignored Terms: promise, domstring, eventinit, cssfontfacerule, event, eventtarget, workerglobalscope
+Ignored Terms: promise, domstring, eventinit, cssfontfacerule, eventtarget, workerglobalscope, document
 </pre>
 
 <h2 id="introduction">
 Introduction</h2>
 
-	<p class='issue'>
-		Fill in intro.
+	CSS allows authors to load custom fonts from the web via the ''@font-face'' rule.
+	While this is easy to use when authoring a stylesheet,
+	it's much more difficult to use dynamically via scripting.
+
+	Further, CSS allows the user agent to choose when to actually load a font;
+	if a font face isn't <em>currently</em> used by anything on a page,
+	most user agents will not download its associated file.
+	This means that later use of the font face will incur a delay
+	as the user agent finally notices a usage and begins downloading and parsing the font file.
+
+	This specification defines a scripting interface to font faces in CSS,
+	allowing font faces to be easily created and loaded from script.
+	It also provides methods to track the loading status of an individual font,
+	or of all the fonts on an entire page.
 
 <h2 id="fontface-interface">
 The <code>FontFace</code> Interface</h2>
@@ -251,7 +263,8 @@ Interaction with CSS’s ''@font-face'' Rule</h3>
 	This <a interface>FontFace</a> object is <dfn>CSS-connected</dfn>.
 
 	The <a interface>FontFace</a> object corresponding to a ''@font-face'' rule
-	has its <a attribute>family</a>, <a attribute>style</a>, <a attribute>weight</a>, <a attribute>stretch</a>, <a attribute>unicodeRange</a>, <a attribute>variant</a>, and <a attribute>featureSettings</a> attributes set to the same value as the corresponding descriptors in the ''@font-face'' rule.
+	has its <a attribute>family</a>, <a attribute>style</a>, <a attribute>weight</a>, <a attribute>stretch</a>, <a attribute>unicodeRange</a>, <a attribute>variant</a>, and <a attribute>featureSettings</a> attributes
+	set to the same value as the corresponding descriptors in the ''@font-face'' rule.
 	There is a two-way connection between the two:
 	any change made to a ''@font-face'' descriptor is immediately reflected in the corresponding <a interface>FontFace</a> attribute,
 	and vice versa.
@@ -261,7 +274,9 @@ Interaction with CSS’s ''@font-face'' Rule</h3>
 
 	Otherwise, a <a interface>FontFace</a> object created by a CSS ''@font-face'' rule is identical to one created manually.
 
-	If a ''@font-face'' rule is removed from the document, its corresponding <a interface>FontFace</a> object is no longer <a>CSS-connected</a>.  The connection is not restorable by any means (but adding the ''@font-face'' back to the stylesheet will create a brand new <a interface>FontFace</a> object which <em>is</em> <a>CSS-connected</a>).
+	If a ''@font-face'' rule is removed from the document, its corresponding <a interface>FontFace</a> object is no longer <a>CSS-connected</a>.
+	The connection is not restorable by any means
+	(but adding the ''@font-face'' back to the stylesheet will create a brand new <a interface>FontFace</a> object which <em>is</em> <a>CSS-connected</a>).
 
 
 

css-font-loading/Overview.html

@@ -143,8 +143,20 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
 <h2 class="heading settled heading" data-level=1 id=introduction><span class=secno>1 </span><span class=content>
 Introduction</span><a class=self-link href=#introduction></a></h2>
 
-	<p class=issue id=issue-06b29672><a class=self-link href=#issue-06b29672></a>
-		Fill in intro.
+<p>	CSS allows authors to load custom fonts from the web via the <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule.
+	While this is easy to use when authoring a stylesheet,
+	it’s much more difficult to use dynamically via scripting.
+
+<p>	Further, CSS allows the user agent to choose when to actually load a font;
+	if a font face isn’t <em>currently</em> used by anything on a page,
+	most user agents will not download its associated file.
+	This means that later use of the font face will incur a delay
+	as the user agent finally notices a usage and begins downloading and parsing the font file.
+
+<p>	This specification defines a scripting interface to font faces in CSS,
+	allowing font faces to be easily created and loaded from script.
+	It also provides methods to track the loading status of an individual font,
+	or of all the fonts on an entire page.
 
 <h2 class="heading settled heading" data-level=2 id=fontface-interface><span class=secno>2 </span><span class=content>
 The <code>FontFace</code> Interface</span><a class=self-link href=#fontface-interface></a></h2>
@@ -376,7 +388,8 @@ <h3 class="heading settled heading" data-level=2.4 id=font-face-css-connection><
 	This <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object is <dfn data-dfn-type=dfn data-noexport="" id=css-connected>CSS-connected<a class=self-link href=#css-connected></a></dfn>.
 
 <p>	The <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object corresponding to a <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule
-	has its <a class=idl-code data-link-type=attribute href=#dom-fontface-family title=family>family</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-style title=style>style</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-weight title=weight>weight</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-stretch title=stretch>stretch</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-unicoderange title=unicoderange>unicodeRange</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-variant title=variant>variant</a>, and <a class=idl-code data-link-type=attribute href=#dom-fontface-featuresettings title=featuresettings>featureSettings</a> attributes set to the same value as the corresponding descriptors in the <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule.
+	has its <a class=idl-code data-link-type=attribute href=#dom-fontface-family title=family>family</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-style title=style>style</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-weight title=weight>weight</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-stretch title=stretch>stretch</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-unicoderange title=unicoderange>unicodeRange</a>, <a class=idl-code data-link-type=attribute href=#dom-fontface-variant title=variant>variant</a>, and <a class=idl-code data-link-type=attribute href=#dom-fontface-featuresettings title=featuresettings>featureSettings</a> attributes
+	set to the same value as the corresponding descriptors in the <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule.
 	There is a two-way connection between the two:
 	any change made to a <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> descriptor is immediately reflected in the corresponding <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> attribute,
 	and vice versa.
@@ -386,7 +399,9 @@ <h3 class="heading settled heading" data-level=2.4 id=font-face-css-connection><
 
 <p>	Otherwise, a <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object created by a CSS <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule is identical to one created manually.
 
-<p>	If a <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule is removed from the document, its corresponding <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object is no longer <a data-link-type=dfn href=#css-connected title=css-connected>CSS-connected</a>.  The connection is not restorable by any means (but adding the <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> back to the stylesheet will create a brand new <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object which <em>is</em> <a data-link-type=dfn href=#css-connected title=css-connected>CSS-connected</a>).
+<p>	If a <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> rule is removed from the document, its corresponding <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object is no longer <a data-link-type=dfn href=#css-connected title=css-connected>CSS-connected</a>.
+	The connection is not restorable by any means
+	(but adding the <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule title=@font-face>@font-face</a> back to the stylesheet will create a brand new <a class=idl-code data-link-type=interface href=http://dev.w3.org/csswg/css-font-load-events-3/#dom-fontface title=fontface>FontFace</a> object which <em>is</em> <a data-link-type=dfn href=#css-connected title=css-connected>CSS-connected</a>).
 
 
 
@@ -1115,9 +1130,6 @@ <h2 class="no-num no-ref heading settled heading" id=property-index><span class=
 
 
 <h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style="counter-reset: issue"><div class=issue>
-		Fill in intro.
-
-<a href=#issue-06b29672> ↵ </a></div><div class=issue>
 		Document the FontFaceSet behavior for Workers.
 		(They start out empty, but can construct fonts or be sent them via postMessage.)