From 6edd12d25b57bd365b456fa2a6033803a7bb429f Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@gmail.com>
Date: Thu, 3 Oct 2019 15:22:25 -0400
Subject: [PATCH 1/2] deprecate role=directory

closes #1076
---
 index.html | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index c4f192e3c..0b072ee32 100644
--- a/index.html
+++ b/index.html
@@ -2776,8 +2776,9 @@ <h2>Definition of Roles</h2>
 		<div class="role" id="directory">
 			<rdef>directory</rdef>
 			<div class="role-description">
-				<p>A list of references to members of a group, such as a static table of contents.</p>
-				<p>Authors SHOULD use this <a>role</a> for a static table of contents, whether linked or unlinked. This includes tables of contents built with lists, including nested lists. Dynamic tables of contents, however, might use a <rref>tree</rref> role instead.</p>
+				<p>[Deprecated in ARIA 1.2] A list of references to members of a group, such as a static table of contents.</p>
+				<p class="note">As exposed by accessibility APIs the <code>directory</code> <a>role</a> provides no benefits to users over using the <code>list</code> <a>role</a>. Authors are advised to treat <code>directory</code> as deprecated and to use <code>list</code>, or a host language's equivalent semantics instead.</p>
+				<p>A <code>directory</code> is a static table of contents, whether linked or unlinked. This includes tables of contents built with lists, including nested lists. Dynamic tables of contents, however, might use a <rref>tree</rref> role instead.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>

From fe4e66ec274671bd0193ba14831cbb0298fb154a Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@users.noreply.github.com>
Date: Wed, 9 Oct 2019 21:05:51 -0400
Subject: [PATCH 2/2] Update index.html

i like it, thanks

Co-Authored-By: Matt King <a11yThinker@Gmail.com>
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 0b072ee32..09346543f 100644
--- a/index.html
+++ b/index.html
@@ -2777,7 +2777,7 @@ <h2>Definition of Roles</h2>
 			<rdef>directory</rdef>
 			<div class="role-description">
 				<p>[Deprecated in ARIA 1.2] A list of references to members of a group, such as a static table of contents.</p>
-				<p class="note">As exposed by accessibility APIs the <code>directory</code> <a>role</a> provides no benefits to users over using the <code>list</code> <a>role</a>. Authors are advised to treat <code>directory</code> as deprecated and to use <code>list</code>, or a host language's equivalent semantics instead.</p>
+				<p class="note">As exposed by accessibility APIs, the <code>directory</code> <a>role</a> is essentially equivalent to the <code>list</code> <a>role</a>. So, using <code>directory</code> does not provide any additional benefits to assistive technology users. Authors are advised to treat <code>directory</code> as deprecated and to use <code>list</code>, or a host language's equivalent semantics instead.</p>
 				<p>A <code>directory</code> is a static table of contents, whether linked or unlinked. This includes tables of contents built with lists, including nested lists. Dynamic tables of contents, however, might use a <rref>tree</rref> role instead.</p>
 			</div>
 			<table class="role-features">