From c625cb7055f006fbacc14a7d0b2270dadd3b7b42 Mon Sep 17 00:00:00 2001
From: Scott O'Hara <scottaohara@users.noreply.github.com>
Date: Thu, 1 Sep 2022 15:21:10 -0400
Subject: [PATCH] update figure role (#1705)

* update figure role
  This PR requires #1703 be merged.
* Update index.html
* revisions per sarah's review
* further updates to figure def
---
 index.html | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/index.html b/index.html
index ab8dda869..5e5f792e6 100644
--- a/index.html
+++ b/index.html
@@ -3425,9 +3425,11 @@ <h2>Definition of Roles</h2>
 		<div class="role" id="figure">
 			<rdef>figure</rdef>
 			<div class="role-description">
-				<p>A perceivable <rref>section</rref> of content that typically contains a <a>graphical document</a>, images, code snippets, or example text. The parts of a <code>figure</code> MAY be user-navigable.</p>
-				<p>Authors SHOULD provide a reference to the <code>figure</code> from the main text, but the <code>figure</code> need not be displayed at the same location as the referencing element. Authors MAY reference text serving as a caption using <pref>aria-describedby</pref>. Authors MAY provide a label using <pref>aria-label</pref> or MAY reference text serving as a label using <pref>aria-labelledby</pref>.</p>
-				<p><a>Assistive technologies</a> SHOULD enable users to quickly navigate to figures. [=User agents=] MAY enable users to quickly navigate to figures.</p>
+				<p>A perceivable <rref>section</rref> of content that typically contains a <a>graphical document</a>, images, media player, code snippets, or example text. The parts of a <code>figure</code> MAY be user-navigable.</p>
+				<p>Authors SHOULD provide a reference to the <code>figure</code> from the main text, but the <code>figure</code> need not be displayed at the same location as the referencing element. Authors MAY provide a <code>figure</code> a <rref>caption</rref> which can include its name, descriptive text, or both. If a <code>caption</code> is provided, and it serves as a description to the contents of the <code>figure</code>, authors SHOULD associate it to the <code>figure</code> element using <pref>aria-details</pref>.</p>
+				<p>Authors MAY provide a <code>figure</code> an accessible name using <pref>aria-label</pref> or use <pref>aria-labelledby</pref> to reference other text in the page to serve as the element's label and accessible name.</p>
+				<p>Please refer to the <rref>caption</rref> role for more information on how to associate a <code>figure</code> with its <code>caption</code>.</p>
+				<p><a>Assistive technologies</a> SHOULD enable users to quickly navigate to figures. <a>User agents</a> MAY enable users to quickly navigate to figures.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>