Merge pull request #23 from w3c/fix/doc-example-figure

Change superclass of doc-example to figure

index.html

@@ -2066,12 +2066,11 @@ <h2>Definition of Roles</h2>
 				<div class="role">
 					<rdef>doc-example</rdef>
 					<div class="role-description">
-						<p>An illustration of a key concept of the work, such as a code listing, case study or
-							problem.</p>
-						<pre class="example highlight">&lt;aside role="doc-example"&gt;
-   &lt;h1&gt;Hello World!&lt;/h1&gt;
+						<p>An illustration of a key concept of the work, such as a code listing, case study or problem.</p>
+						<pre class="example highlight">&lt;figure role="doc-example"&gt;
+   &lt;figcaption&gt;Example 1 &#8212; Hello World!&lt;/figcaption&gt;
    &#8230;
-&lt;/aside></pre>
+&lt;/figure></pre>
 					</div>
 					<table class="role-features">
 						<caption>Characteristics:</caption>
@@ -2088,7 +2087,7 @@ <h2>Definition of Roles</h2>
 							</tr>
 							<tr>
 								<th class="role-parent-head" scope="row">Superclass Role:</th>
-								<td class="role-parent"><rref>section</rref></td>
+								<td class="role-parent"><rref>figure</rref></td>
 							</tr>
 							<tr>
 								<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -3957,13 +3956,15 @@ <h1>Candidate Recommendation Exit Criteria</h1>
 			<h2>Change Log</h2>
 			<section>
 				<h2>Substantive changes since the <a href="https://www.w3.org/TR/dpub-aria-1.0/">DPUB-ARIA 1.0
-						Recommendation</a></h2>
+					Recommendation</a></h2>
 				<ul>
 					<!-- EdNote: After each WD publish, move contents of this list into the next one below. -->
 					<li>25-July-2020: Recommend that doc-pagebreak name be end user-consumable.</li>
+					<li>24-July-2020: Changed the superclass of <rref>doc-example</rref> to <rref>figure</rref> to
+							make compatible with use on HTML figure.</li>
 				</ul>
 			</section>
-			<!-- <section>
+			<!--  <section>
 				<h2>Other substantive changes since the <a href="http://www.w3.org/TR/2015/WD-dpub-aria-1.0-20150707/">First
 						Public Working Draft</a></h2>
 				<ul>