[css-content] Tighten up a11y wording, clean up link targets

Author: fantasai

css-content/Overview.bs

@@ -1,7 +1,7 @@
 <h1>CSS Generated Content Module Level 3</h1>
 <pre class='metadata'>
 Status: WD
-Date: 2016-05-31
+Date: 2016-06-02
 Work Status: Exploring
 Shortname: css-content
 Level: 3
@@ -16,7 +16,7 @@ Former Editor: Ian Hickson, Google, ian@hixie.ch
 Ignored Terms: <datetime>, leader(), string(), target-counter(), target-counters(), target-text()
 Abstract: This CSS3 Module describes how to insert content in a document.
 Link Defaults: css21 (type) <uri>, css-display-3 (value) inline
-Warning: Not Ready
+Status Text: This is a very rough draft, and is not ready for implementation.
 </pre>
 
 
@@ -34,7 +34,7 @@ Warning: Not Ready
  !
  !-->
 
-<h2 class="no-num" id="introduction">
+<h2 class="no-num" id="intro">
 	Introduction
 </h2>
 
@@ -77,7 +77,7 @@ figure:not([alt]) { content: attr(href, url), contents; }
 
 
 
-<h2 id="inserting-replacing-content">Inserting and replacing content with the 'content' property</h2>
+<h2 id="content-property">Inserting and replacing content with the 'content' property</h2>
 
 <pre class='propdef'>
     Name: content
@@ -120,30 +120,36 @@ See sections below for details on each of these.
 
 </dl>
 
-Issue: should the contents keyword be replaced with ''content()''
+Issue: Should the contents keyword be replaced with ''content()''?
 
 
 
 
 
-	<p id="replacedContent">If the computed value of the part of the 'content' property that ends up being used is a single URI, then the element or pseudo-element is a replaced element. The box model defines different rules for the layout of replaced elements than normal elements. Replaced elements do not have '::before' and '::after' pseudo-elements; the 'content' property in the case of replaced content replaces the entire contents of the element's box.
+	<p id="replaced">If the computed value of the part of the 'content' property that ends up being used is a single URI, then the element or pseudo-element is a replaced element. The box model defines different rules for the layout of replaced elements than normal elements. Replaced elements do not have '::before' and '::after' pseudo-elements; the 'content' property in the case of replaced content replaces the entire contents of the element's box.
 
-<h3 id="accessibility-of-generated-content">
+<h3 id="accessibility">
 Accessibility of Generated Content</h3>
 
-   Generated content should be searchable, selectable, and available to assistive technologies. 
+   Generated content should be searchable, selectable, and available to assistive technologies.
+   The 'content' property applies to speech
+   and generated content must be rendered for speech output. [[!CSS3-SPEECH]]
 
    Issue: Start work on an AAM for CSS. 
 
-   Generated content often needs alternative text. 
-   If the value of the content property is a string, 
-   this string should be used by assistive technology
-   unless an alternative is provided. This allows
-   purely decorative text to be ignored by providing
-   the empty string as alternative text. 
-   Appropriate alternative text must be provided for
-   images inserted via the content property as well.
+<h3 id="alt">
+Alternative Text for Speech</h3>
 
+   Content intended for visual media sometimes needs alternative text for speech output.
+   The 'content' property thus accepts alternative text
+   to be specified after a slash (''/'') after the last <<content-list>>.
+   If such alternative text is provided,
+   it must be used for speech output instead.
+
+   This allows, for example, purely decorative text to be elided in speech output
+   (by providing the empty string as alternative text),
+   and allows authors to provide more readable alternatives
+   to images, icons, or text-encoded symbols.
 
   <!--examples from CSS-PSEUDO, redone with our new syntax-->
 
@@ -173,19 +179,15 @@ Accessibility of Generated Content</h3>
 
   <!--end copy from CSS-PSEUDO-->
 
-
-
-
-
-<h2 id="content-functions">
+<h2 id="content-values">
 Content Values and Functions</h2>
 
 	The 'content' property can be used to add many different types of content to a document,
     including images, strings, the values of counters, and the text value of elements. 
     In this section we enumerate the possibilities. 
 
 
-<h3 id="content-string">
+<h3 id="strings">
 String</h3>
 
 	<dl dfn-for="content, <content-list>" dfn-type=value>
@@ -229,15 +231,15 @@ URI</h3>
 
 	<p class="issue">There appears to be some change from [[CSS21]] which says, "If the user agent cannot display the resource it must either leave it out as if it were not specified or display some indication that the resource cannot be displayed." Are we now saying that a user agent cannot display a missing image graphic in this situation?
 
-	When a URI is used as replaced content, it <a href="#replacedContent">affects the generation</a> of ''::before'' and ''::after'' pseudo-elements.
+	When a URI is used as replaced content, it <a href="#replaced">affects the generation</a> of ''::before'' and ''::after'' pseudo-elements.
 
 
 
 
 
 
 
-<h3 id="content-contents">
+<h3 id="contents">
 contents</h3>
 
 <dl dfn-for="content, <content-list>" dfn-type=value>
@@ -297,7 +299,7 @@ Quotes</h3>
 	HTML has long had the <code>q</code> element, used to delimit quotations. The ''quotes'' property, in conjunction with the various *-quote values of the 'content' property, can be used to properly style such quotations.
 
 
-<h4 id="specifying-quotes">
+<h4 id="quotes-property">
 Specifying quotes with the 'quotes' property</h4>
 
 
@@ -331,7 +333,7 @@ This property specifies quotation marks for any number of embedded quotations. V
 </dl>
 
 
-<h4 id="inserting-quotes">
+<h4 id="quote-values">
 The *-quote values of the content property
 </h4>
 
@@ -347,10 +349,10 @@ The *-quote values of the content property
 
 		<dt><dfn>open-quote</dfn>
 		<dt><dfn>close-quote</dfn>
-		<dd>These values are replaced by the appropriate string from the 'quotes' property, and increments (decrements) the level of nesting for quotes. See [[#specifying-quotes]] for more information.
+		<dd>These values are replaced by the appropriate string from the 'quotes' property, and increments (decrements) the level of nesting for quotes. See [[#quotes-property]] for more information.
 		<dt><dfn>no-open-quote</dfn>
 		<dt><dfn>no-close-quote</dfn>
-		<dd>Inserts nothing (as in ''content/none''), but increments (decrements) the level of nesting for quotes. See [[#specifying-quotes]] for more information.
+		<dd>Inserts nothing (as in ''content/none''), but increments (decrements) the level of nesting for quotes. See [[#quotes-property]] for more information.
 
 	</dl>
 
@@ -477,7 +479,7 @@ Leaders</h3>
 
 	A leader, sometimes known as a tab leader or a dot leader, is a repeating pattern used to visually connect content across horizontal spaces. They are most commonly used in tables of contents, between titles and page numbers. The ''leader()'' function, as a value for the content property, is used to create leaders in CSS. This function takes a string (the leader string), which describes the repeating pattern for the leader.
 
-<h4 id="content-leader-function">
+<h4 id="leader-function">
 The ''leader()'' function
 </h4>
 
@@ -533,7 +535,7 @@ The ''leader()'' function
 <p class="issue">
 Do leaders depend on the assumption that the content after the leader is right-aligned (end-aligned)?
 
-<h4 id="rendering-leaders">
+<h4 id="leader-rules">
 Rendering leaders
 </h4>
 
@@ -548,7 +550,7 @@ Rendering leaders
 <li>A leader only appears on a single line, even if the before content and after content are on different lines.
 <li>A leader can’t be the only thing on a line.
 </ol>
-<h4 id="procedure-leader">
+<h4 id="leader-alignment">
 Procedure for rendering leaders
 </h4>
 <ol>
@@ -736,10 +738,10 @@ a::after { content: ", in the chapter entitled " target-text(attr(href url)) }
 
 
 
-<h3 id="named-strings-heading">
+<h3 id="named-strings">
 Named strings</h3>
 
-This section introduces <dfn>named strings</dfn>, which are the textual equivalent of counters and which have a distinct namespace from counters. Named strings follow the same nesting rules as counters. The 'string-set' property accepts values similar to the 'content' property, including the extraction of the current value of counters.
+This section introduces <dfn lt="named string">named strings</dfn>, which are the textual equivalent of counters and which have a distinct namespace from counters. Named strings follow the same nesting rules as counters. The 'string-set' property accepts values similar to the 'content' property, including the extraction of the current value of counters.
 
 Named strings are a convenient way to pull metadata out of the document for insertion into headers and footers. In HTML, for example, META elements contained in the document HEAD can set the value of named strings. In conjunction with attribute selectors, this can be a powerful mechanism:
 
@@ -770,7 +772,7 @@ head &gt; title { string-set: title contents; }
 
 
 
-<h4 id="setting-named-strings-the-string-set-pro">
+<h4 id="string-set">
 The string-set property
 </h4>
 
@@ -819,7 +821,7 @@ The 'string-set' property copies the text content of an element into a ''named s
 </div>
 
 
-<h4 id="using-named-strings">The ''string()'' function</h4>
+<h4 id="string-function">The ''string()'' function</h4>
 
 <pre class="prod">
 	<dfn>string()</dfn> = string( <<custom-ident>> , [ first | start | last | first-except ]? )
@@ -899,7 +901,7 @@ The content values of named strings are assigned at the point when the content b
 
 
 
-<h4 id="content-function-header">The ''content()'' function</h4>
+<h4 id="content-function">The ''content()'' function</h4>
 
 <pre class="prod">
 	<dfn>content()</dfn> = content( [text | before | after | first-letter | marker ]? )
@@ -983,7 +985,7 @@ Automatic counters and numbering: the 'counter-increment' and 'counter-reset' pr
 
 
 
-<h2 id="css-bookmarks">
+<h2 id="bookmark-generation">
 Bookmarks
 </h2>
 Some document formats, most notably PDF, allow the use of <dfn>bookmarks</dfn> as an aid to navigation. Bookmarks provide a hierarchy of links to document elements, as well as text to label the links. A bookmark has three properties: 'bookmark-level', 'bookmark-label', and 'bookmark-state'.
@@ -1120,7 +1122,7 @@ Issue: is the initial bookmark state, or the bookmark state updated by the UA as
 
 * Dave Cramer added as co-editor. Ian Hickson and Håkon Wium Lie are now former editors.
 
-<h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
+<h2 class="no-num" id="acknowledgements">Acknowledgements</h2>
 
 Stuart Ballard, David Baron, Bert Bos, and <span lang="tr">Tantek Çelik</span> provided invaluable suggestions used in this
 specification.