From 1f2dcec67166164f144274036e530485c01d6a01 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Wed, 12 Jun 2019 19:33:51 -0400
Subject: [PATCH 1/9] generic role (without aria-textseparation)

---
 index.html | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 91 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 7ae7c267c..9a1410f27 100644
--- a/index.html
+++ b/index.html
@@ -672,7 +672,7 @@ <h3>Widget Roles</h3>
 			</ul>
 		</section>
 		<section id="document_structure_roles">
-			<h3>Document Structure</h3>
+			<h3>Document Structure Roles</h3>
 			<p>The following <a>roles</a> describe structures that organize content in a page. Document structures are not usually interactive.</p>
 			<ul>
 				<li><rref>application</rref></li>
@@ -691,6 +691,7 @@ <h3>Document Structure</h3>
 				<li><rref>emphasis</rref></li>
 				<li><rref>feed</rref></li>
 				<li><rref>figure</rref></li>
+				<li><rref>generic</rref></li>
 				<li><rref>group</rref></li>
 				<li><rref>heading</rref></li>
 				<li><rref>img</rref></li>
@@ -3270,6 +3271,95 @@ <h2>Definition of Roles</h2>
 				</tbody>
 			</table>
 		</div>
+		<div class="role" id="generic">
+			<rdef>generic</rdef>
+			<div class="role-description">
+				<p>A nameless container <a>element</a> that has no semantic meaning on its own, but can provide accessible states and properties for its descendants.</p>
+				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
+			</div>
+			<table class="role-features">
+				<caption>Characteristics:</caption>
+				<thead>
+					<tr>
+						<th scope="col">Characteristic</th>
+						<th scope="col">Value</th>
+					</tr>
+				</thead>
+				<tbody>
+					<tr>
+						<th class="role-abstract-head" scope="row">Is Abstract:</th>
+						<td class="role-abstract"> </td>
+					</tr>
+					<tr>
+						<th class="role-parent-head" scope="row">Superclass Role:</th>
+						<td class="role-parent"><rref>structure</rref></td>
+					</tr>
+					<tr>
+						<th class="role-children-head" scope="row">Subclass Roles:</th>
+						<td class="role-children">Placeholder</td>
+					</tr>
+					<tr>
+						<th class="role-base-head" scope="row">Base Concept:</th>
+						<td class="role-base"> </td>
+					</tr>
+					<tr>
+						<th class="role-related-head" scope="row">Related Concepts:</th>
+						<td class="role-related"><a href="https://www.w3.org/TR/html/grouping-content.html#the-div-element"><abbr title="Hypertext Markup Language">HTML</abbr> <code>div</code></a>, <a href="https://www.w3.org/TR/html/textlevel-semantics.html#the-span-element"><abbr title="Hypertext Markup Language">HTML</abbr> <code>span</code></a></td>
+					</tr>
+					<tr>
+						<th class="role-scope-head" scope="row">Required Context Role:</th>
+						<td class="role-scope"> </td>
+					</tr>
+					<tr>
+						<th class="role-mustcontain-head" scope="row">Required Owned Elements:</th>
+						<td class="role-mustcontain"> </td>
+					</tr>
+					<tr>
+						<th class="role-required-properties-head">Required States and Properties:</th>
+						<td class="role-required-properties"> </td>
+					</tr>
+					<tr>
+						<th class="role-properties-head" scope="row">Supported States and Properties:</th>
+						<td class="role-properties"> </td>
+					</tr>
+					<tr>
+						<th class="role-inherited-head" scope="row">Inherited States and Properties:</th>
+						<td class="role-inherited">Placeholder</td>
+					</tr>
+					<!-- see pr #985
+					<tr>
+						<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
+						<td class="role-disallowed">
+							<ul>
+								<li><pref>aria-label</pref></li>
+								<li><pref>aria-labelledby</pref></li>
+							</ul>					
+						</td>
+					</tr>
+					-->
+					<tr>
+						<th class="role-namefrom-head" scope="row">Name From:</th>
+						<td class="role-namefrom">prohibited</td>
+					</tr>
+					<tr>
+						<th class="role-namerequired-head" scope="row">Accessible Name Required:</th>
+						<td class="role-namerequired"> </td>
+					</tr>
+					<tr>
+						<th class="role-namerequired-inherited-head" scope="row">Inherits Name Required:</th>
+						<td class="role-namerequired-inherited"> </td>
+					</tr>
+					<tr>
+						<th class="role-childpresentational-head" scope="row">Children Presentational:</th>
+						<td class="role-childpresentational"> </td>
+					</tr>
+					<tr>
+						<th class="role-presentational-inherited-head" scope="row">Inherits Presentational:</th>
+						<td class="role-presentational-inherited"> </td>
+					</tr>
+				</tbody>
+			</table>
+		</div>
 		<div class="role" id="grid">
 			<rdef>grid</rdef>
 			<div class="role-description">

From 9e1224707be2430a96e1278fb7f485f2c3e57603 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Thu, 27 Jun 2019 00:53:19 -0400
Subject: [PATCH 2/9] - split intro sentence into 2 sentences - add note saying
 authors should not use in content - add editor's note about global properties
 triage

---
 index.html | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 9a1410f27..db4706967 100644
--- a/index.html
+++ b/index.html
@@ -3274,8 +3274,11 @@ <h2>Definition of Roles</h2>
 		<div class="role" id="generic">
 			<rdef>generic</rdef>
 			<div class="role-description">
-				<p>A nameless container <a>element</a> that has no semantic meaning on its own, but can provide accessible states and properties for its descendants.</p>
+				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
+				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>.</p>
+				<p class="note"><code>generic</code> is a superclass role used for the ontology. With the exception of providing <code>generic</code> <a href="https://html.spec.whatwg.org/multipage/custom-elements.html">Custom Elements</a>, authors should not use this role in content.</p>
+				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>

From 5466773e46b8af57f5036a23755c43c1c077496f Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Thu, 27 Jun 2019 11:16:32 -0400
Subject: [PATCH 3/9] Add HTML before "Custom Elements"

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index db4706967..bc82cf50c 100644
--- a/index.html
+++ b/index.html
@@ -3277,7 +3277,7 @@ <h2>Definition of Roles</h2>
 				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
 				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>.</p>
-				<p class="note"><code>generic</code> is a superclass role used for the ontology. With the exception of providing <code>generic</code> <a href="https://html.spec.whatwg.org/multipage/custom-elements.html">Custom Elements</a>, authors should not use this role in content.</p>
+				<p class="note"><code>generic</code> is a superclass role used for the ontology. With the exception of providing <code>generic</code> <abbr title="Hypertext Markup Language">HTML</abbr> <a href="https://html.spec.whatwg.org/multipage/custom-elements.html">Custom Elements</a>, authors should not use this role in content.</p>
 				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>
 			<table class="role-features">

From 25fec152a284e8d2a301636da37d1403f125e60f Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Fri, 28 Jun 2019 09:27:03 -0400
Subject: [PATCH 4/9] Delete "superclass"

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index bc82cf50c..429c7ae59 100644
--- a/index.html
+++ b/index.html
@@ -3277,7 +3277,7 @@ <h2>Definition of Roles</h2>
 				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
 				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>.</p>
-				<p class="note"><code>generic</code> is a superclass role used for the ontology. With the exception of providing <code>generic</code> <abbr title="Hypertext Markup Language">HTML</abbr> <a href="https://html.spec.whatwg.org/multipage/custom-elements.html">Custom Elements</a>, authors should not use this role in content.</p>
+				<p class="note"><code>generic</code> is a role used for the ontology. With the exception of providing <code>generic</code> <abbr title="Hypertext Markup Language">HTML</abbr> <a href="https://html.spec.whatwg.org/multipage/custom-elements.html">Custom Elements</a>, authors should not use this role in content.</p>
 				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>
 			<table class="role-features">

From 3e4b95165b9928021733e0914d85ed95e70a5196 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Wed, 17 Jul 2019 23:51:31 -0400
Subject: [PATCH 5/9] Simplify note

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 429c7ae59..200df331d 100644
--- a/index.html
+++ b/index.html
@@ -3277,7 +3277,7 @@ <h2>Definition of Roles</h2>
 				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
 				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>.</p>
-				<p class="note"><code>generic</code> is a role used for the ontology. With the exception of providing <code>generic</code> <abbr title="Hypertext Markup Language">HTML</abbr> <a href="https://html.spec.whatwg.org/multipage/custom-elements.html">Custom Elements</a>, authors should not use this role in content.</p>
+				<p class="note"><code>generic</code> role is intended for implementors of User Agents. Authors should not use this role in content.</p>
 				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>
 			<table class="role-features">

From c9262155af1800c853d36ba174c0843ebecc5103 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Thu, 18 Jul 2019 00:05:19 -0400
Subject: [PATCH 6/9] Differentiate from presentation

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 200df331d..80e6a48db 100644
--- a/index.html
+++ b/index.html
@@ -3276,7 +3276,7 @@ <h2>Definition of Roles</h2>
 			<div class="role-description">
 				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
-				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>.</p>
+				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>. This differentiates it from the <rref>presentation</rref> role.</p>
 				<p class="note"><code>generic</code> role is intended for implementors of User Agents. Authors should not use this role in content.</p>
 				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>

From 56496738c14de9e58fc950838816302526f2c7e7 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Thu, 18 Jul 2019 00:13:30 -0400
Subject: [PATCH 7/9] Uncomment "Prohibited States and Properties" in table

---
 index.html | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/index.html b/index.html
index 80e6a48db..69c8792ae 100644
--- a/index.html
+++ b/index.html
@@ -3329,7 +3329,6 @@ <h2>Definition of Roles</h2>
 						<th class="role-inherited-head" scope="row">Inherited States and Properties:</th>
 						<td class="role-inherited">Placeholder</td>
 					</tr>
-					<!-- see pr #985
 					<tr>
 						<th class="role-disallowed-head" scope="row">Prohibited States and Properties:</th>
 						<td class="role-disallowed">
@@ -3338,8 +3337,7 @@ <h2>Definition of Roles</h2>
 								<li><pref>aria-labelledby</pref></li>
 							</ul>					
 						</td>
-					</tr>
-					-->
+					</tr>						
 					<tr>
 						<th class="role-namefrom-head" scope="row">Name From:</th>
 						<td class="role-namefrom">prohibited</td>

From d970423be37a49a17a2d60208f902bff4f6e9f25 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Fri, 19 Jul 2019 11:33:30 -0400
Subject: [PATCH 8/9] Remove "note" and use normative SHOULD NOT

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 69c8792ae..3b2209348 100644
--- a/index.html
+++ b/index.html
@@ -3277,7 +3277,7 @@ <h2>Definition of Roles</h2>
 				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
 				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>. This differentiates it from the <rref>presentation</rref> role.</p>
-				<p class="note"><code>generic</code> role is intended for implementors of User Agents. Authors should not use this role in content.</p>
+				<p>The <code>generic</code> role is intended for implementors of User Agents. Authors SHOULD NOT use this role in content.</p>
 				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>
 			<table class="role-features">

From 3e48334a59463e6f31f5af4aa33fff9ab89908f2 Mon Sep 17 00:00:00 2001
From: Carolyn MacLeod <Carolyn_MacLeod@ca.ibm.com>
Date: Fri, 19 Jul 2019 11:38:00 -0400
Subject: [PATCH 9/9] remove aria-hidden (i.e. doesn't differentiate from role
 presentation)

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 3b2209348..e09fdda90 100644
--- a/index.html
+++ b/index.html
@@ -3276,7 +3276,7 @@ <h2>Definition of Roles</h2>
 			<div class="role-description">
 				<p>A nameless container <a>element</a> that has no semantic meaning on its own.</p>
 				<p>Contrast with <rref>group</rref>, which semantically groups its descendants in a named container.</p>
-				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <sref>aria-hidden</sref> and <pref>aria-live</pref>. This differentiates it from the <rref>presentation</rref> role.</p>
+				<p>A <code>generic</code> can provide a limited number of accessible states and properties for its descendants, such as <pref>aria-live</pref> attributes. This differentiates it from the <rref>presentation</rref> role.</p>
 				<p>The <code>generic</code> role is intended for implementors of User Agents. Authors SHOULD NOT use this role in content.</p>
 				<p class="ednote">A triage of global properties is pending. This will reduce the number of inherited states and properties in the characteristics table below. For details, see <a href="https://github.com/w3c/aria/issues/999">issue #999</a>.</p>
 			</div>