From 8b4374d8ad1a37ba7bd0cb3d76b081dd870305ed Mon Sep 17 00:00:00 2001
From: Matt Garrish <matt.garrish@gmail.com>
Date: Fri, 6 Mar 2015 15:04:07 -0500
Subject: [PATCH] updated definitions; renamed referrer to locator; commented
 out assessment terms pending further review/coordination with other
 interested groups

---
 aria/dpub.html | 121 ++++++++++++++++++++++++++-----------------------
 1 file changed, 65 insertions(+), 56 deletions(-)

diff --git a/aria/dpub.html b/aria/dpub.html
index c83342b24..85a2cd3e4 100644
--- a/aria/dpub.html
+++ b/aria/dpub.html
@@ -380,7 +380,7 @@ <h2>Definition of Roles</h2>
 			</table>
 		</div>
 		<hr/>
-		<div class="role">
+	<!-- <div class="role">
 			<rdef>answer</rdef>
 			<div class="role-description">
 				<p>The component of an assessment problem that provides the answer to the question.</p>
@@ -625,7 +625,7 @@ <h2>Definition of Roles</h2>
 				</tbody>
 			</table>
 		</div>
-		<hr/>
+		<hr/> -->
 		<div class="role">
 			<rdef>biblioentry</rdef>
 			<div class="role-description">
@@ -1118,7 +1118,7 @@ <h2>Definition of Roles</h2>
 			</table>
 		</div>
 		<hr/>
-		<div class="role">
+	<!--	<div class="role">
 			<rdef>feedback</rdef>
 			<div class="role-description">
 				<p>Instruction or advice returned to the user based on the result of an interactive activity, such as an assessment.</p>
@@ -1363,7 +1363,7 @@ <h2>Definition of Roles</h2>
 				</tbody>
 			</table>
 		</div>
-		<hr/>
+		<hr/> -->
 		<div class="role">
 			<rdef>foreword</rdef>
 			<div class="role-description">
@@ -1783,7 +1783,7 @@ <h2>Definition of Roles</h2>
 		<div class="role">
 			<rdef>help</rdef>
 			<div class="role-description">
-				<p>Information that clarifies or augments the content.</p>
+				<p>Helpful information - such as a tip, hint or suggestion - that clarifies some aspect of the content or assists in its comprehension.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2031,6 +2031,9 @@ <h2>Definition of Roles</h2>
 			<div class="role-description">
 				<p>A goal statement that captures the specific knowledge or skills the user is expected to learn.</p>
 			</div>
+			<p class="ednote">
+				Need to ensure that the definitions and applicability of this and learning-outcome are clear and unambiguous. May need to reconsider keeping one or both if not.
+			</p>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
 				<thead>
@@ -2113,6 +2116,9 @@ <h2>Definition of Roles</h2>
 			<div class="role-description">
 				<p>A demonstrable, measurable mastery of a learning objective used for diagnostic capabilities.</p>
 			</div>
+			<p class="ednote">
+				Need to ensure that the definitions and applicability of this and learning-objective are clear and unambiguous. May need to reconsider keeping one or both if not.
+			</p>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
 				<thead>
@@ -2191,10 +2197,13 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>noteref</rdef>
+			<rdef>locator</rdef>
 			<div class="role-description">
-				<p>A reference to a note, typically appearing a superscripted symbol in the main body of text.</p>
+				<p>A link that allows the user to jump to a related location in the content (e.g., from a footnote to its reference, from an index entry to where the topic is discussed, or from a glossary definition to where the term is used).</p>
 			</div>
+			<p class="ednote">
+				The name and definition for this end of what are typically bidirectional linking relationships are still under consideration.
+			</p>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
 				<thead>
@@ -2222,7 +2231,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#noteref">noteref</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#referrer">referrer</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2273,9 +2282,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>notice</rdef>
+			<rdef>noteref</rdef>
 			<div class="role-description">
-				<p>Information that requires special attention from the user. Examples include: alert, warning, caution, danger, important.</p>
+				<p>A reference to a note, typically appearing a superscripted symbol in the main body of text.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2292,7 +2301,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"><rref>alert</rref></td>
+						<td class="role-parent"><rref>link</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2304,7 +2313,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#notice">notice</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#noteref">noteref</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2355,9 +2364,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>page-list</rdef>
+			<rdef>notice</rdef>
 			<div class="role-description">
-				<p>A navigation aid that provides a list of links to the pagebreaks in the content.</p>
+				<p>Information that requires special attention from the user. Examples include: alert, warning, caution, danger, important.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2374,7 +2383,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"><rref>directory</rref></td>
+						<td class="role-parent"><rref>alert</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2386,7 +2395,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#page-list">page-list</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#notice">notice</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2437,9 +2446,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>pagebreak</rdef>
+			<rdef>page-list</rdef>
 			<div class="role-description">
-				<p>A separator denoting the position before which a break occurs between two contiguous pages in a statically paginated version of the content.</p>
+				<p>A navigation aid that provides a list of links to the pagebreaks in the content.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2456,7 +2465,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"><rref>separator</rref></td>
+						<td class="role-parent"><rref>directory</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2468,7 +2477,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#pagebreak">pagebreak</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#page-list">page-list</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2519,9 +2528,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>part</rdef>
+			<rdef>pagebreak</rdef>
 			<div class="role-description">
-				<p>A major structural division in a work that contains a set of related sections dealing with a particular subject, narrative arc or similar encapsulated theme.</p>
+				<p>A separator denoting the position before which a break occurs between two contiguous pages in a statically paginated version of the content.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2534,11 +2543,11 @@ <h2>Definition of Roles</h2>
 				<tbody>
 					<tr>
 						<th class="role-abstract-head" scope="row">Is Abstract:</th>
-						<td class="role-abstract"><rref>section</rref></td>
+						<td class="role-abstract"> </td>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"> </td>
+						<td class="role-parent"><rref>separator</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2550,7 +2559,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#part">part</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#pagebreak">pagebreak</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2601,9 +2610,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>practice</rdef>
+			<rdef>part</rdef>
 			<div class="role-description">
-				<p>A review exercise or sample that is not dynamically evaluated. Answers, if provided, are included as text content.</p>
+				<p>A major structural division in a work that contains a set of related sections dealing with a particular subject, narrative arc or similar encapsulated theme.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2616,7 +2625,7 @@ <h2>Definition of Roles</h2>
 				<tbody>
 					<tr>
 						<th class="role-abstract-head" scope="row">Is Abstract:</th>
-						<td class="role-abstract"> </td>
+						<td class="role-abstract"><rref>section</rref></td>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
@@ -2632,7 +2641,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#practice">practice</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#part">part</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2682,10 +2691,10 @@ <h2>Definition of Roles</h2>
 			</table>
 		</div>
 		<hr/>
-		<div class="role">
-			<rdef>preface</rdef>
+	<!--	<div class="role">
+			<rdef>practice</rdef>
 			<div class="role-description">
-				<p>An introductory section that precedes the work, typically written by the author of the work.</p>
+				<p>A review exercise or sample that is not dynamically evaluated. Answers, if provided, are included as text content.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2702,7 +2711,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"> </td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2714,7 +2723,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#preface">preface</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#practice">practice</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2763,11 +2772,11 @@ <h2>Definition of Roles</h2>
 				</tbody>
 			</table>
 		</div>
-		<hr/>
+		<hr/> -->
 		<div class="role">
-			<rdef>prologue</rdef>
+			<rdef>preface</rdef>
 			<div class="role-description">
-				<p>An introductory section that sets the background to a work, typically part of the narrative.</p>
+				<p>An introductory section that precedes the work, typically written by the author of the work.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2796,7 +2805,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#prologue">prologue</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#preface">preface</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2847,9 +2856,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>pullquote</rdef>
+			<rdef>prologue</rdef>
 			<div class="role-description">
-				<p>A distinctively placed or highlighted quotation from the current content designed to draw attention to a topic or highlight a key point.</p>
+				<p>An introductory section that sets the background to a work, typically part of the narrative.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2866,7 +2875,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"><rref>presentation</rref></td>
+						<td class="role-parent"><rref>section</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2878,7 +2887,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#pullquote">pullquote</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#prologue">prologue</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -2929,9 +2938,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>qna</rdef>
+			<rdef>pullquote</rdef>
 			<div class="role-description">
-				<p>A question and answer section.</p>
+				<p>A distinctively placed or highlighted quotation from the current content designed to draw attention to a topic or highlight a key point.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -2948,7 +2957,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>presentation</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -2960,7 +2969,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#qna">qna</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#pullquote">pullquote</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -3011,9 +3020,9 @@ <h2>Definition of Roles</h2>
 		</div>
 		<hr/>
 		<div class="role">
-			<rdef>question</rdef>
+			<rdef>qna</rdef>
 			<div class="role-description">
-				<p>The component of an assessment problem that identifies the question to be solved.</p>
+				<p>A section of content structured as a series of questions and answers, such as an interview or list of frequently asked questions.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -3030,7 +3039,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"> </td>
+						<td class="role-parent"><rref>section</rref></td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -3042,7 +3051,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#question">question</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#qna">qna</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -3092,10 +3101,10 @@ <h2>Definition of Roles</h2>
 			</table>
 		</div>
 		<hr/>
-		<div class="role">
-			<rdef>referrer</rdef>
+	<!--	<div class="role">
+			<rdef>question</rdef>
 			<div class="role-description">
-				<p>A link back to the starting location in a bidirectional linking relationship.</p>
+				<p>The component of an assessment problem that identifies the question to be solved.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
@@ -3112,7 +3121,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-parent-head" scope="row">Superclass Role:</th>
-						<td class="role-parent"><rref>link</rref></td>
+						<td class="role-parent"> </td>
 					</tr>
 					<tr>
 						<th class="role-children-head" scope="row">Subclass Roles:</th>
@@ -3124,7 +3133,7 @@ <h2>Definition of Roles</h2>
 					</tr>
 					<tr>
 						<th class="role-related-head" scope="row">Related Concepts:</th>
-						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#referrer">referrer</a> [[EPUB-SSV]]</td>
+						<td class="role-related">EPUB <a href="http://www.idpf.org/epub/vocab/structure/#question">question</a> [[EPUB-SSV]]</td>
 					</tr>
 					<tr>
 						<th class="role-scope-head" scope="row">Required Context Role:</th>
@@ -3173,7 +3182,7 @@ <h2>Definition of Roles</h2>
 				</tbody>
 			</table>
 		</div>
-		<hr/>
+		<hr/> -->
 		<div class="role">
 			<rdef>subtitle</rdef>
 			<div class="role-description">