From 25ddd3e44a81a52416e859637142c9a58f0af7a6 Mon Sep 17 00:00:00 2001
From: Devon Persing <devon.persing@shopify.com>
Date: Wed, 24 Apr 2019 15:22:44 -0700
Subject: [PATCH 1/4] Added a11y docs for list and stack

---
 src/components/List/README.md  | 30 ++++++++++++++++++++++++++++++
 src/components/Stack/README.md | 28 ++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)

diff --git a/src/components/List/README.md b/src/components/List/README.md
index 743b1521b7a..0111426508b 100644
--- a/src/components/List/README.md
+++ b/src/components/List/README.md
@@ -136,3 +136,33 @@ Use for a text-only list of related items when an inherent order, priority, or s
 - To create a list of checkboxes or radio buttons, [use the choice list component](/components/forms/choice-list)
 - To present a collection of objects of the same type such as customers, products, or orders, [use the resource list component](/components/lists-and-tables/resource-list)
 - When text labels for each item are useful for describing the content, [use the Description List component](/components/lists-and-tables/description-list)
+
+---
+
+## Accessibility
+
+<!-- content-for: android -->
+
+See Material Design and development documentation about accessibility for Android:
+
+- [Accessible design on Android](https://material.io/design/usability/accessibility.html)
+- [Accessible development on Android](https://developer.android.com/guide/topics/ui/accessibility/)
+
+<!-- /content-for -->
+
+<!-- content-for: ios -->
+
+See Apple’s Human Interface Guidelines and API documentation about accessibility for iOS:
+
+- [Accessible design on iOS](https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/accessibility/)
+- [Accessible development on iOS](https://developer.apple.com/accessibility/ios/)
+
+<!-- /content-for -->
+
+<!-- content-for: web -->
+
+The list component outputs list items (`<li>`) inside a list wrapper (`<ul>` for bullet lists or `<ol>` for numbered lists). By default, list items are conveyed as a group of related elements to assistive technology users.
+
+To group items for layout only, consider using the [stack component](/components/structure/stack).
+
+<!-- /content-for -->
diff --git a/src/components/Stack/README.md b/src/components/Stack/README.md
index a9fe12e8e16..a2818acd2a0 100644
--- a/src/components/Stack/README.md
+++ b/src/components/Stack/README.md
@@ -160,3 +160,31 @@ The stack component will treat multiple elements wrapped in a stack item compone
 ## Related components
 
 - To create the large-scale structure of pages, [use the layout component](/components/structure/layout)
+
+---
+
+## Accessibility
+
+<!-- content-for: android -->
+
+See Material Design and development documentation about accessibility for Android:
+
+- [Accessible design on Android](https://material.io/design/usability/accessibility.html)
+- [Accessible development on Android](https://developer.android.com/guide/topics/ui/accessibility/)
+
+<!-- /content-for -->
+
+<!-- content-for: ios -->
+
+See Apple’s Human Interface Guidelines and API documentation about accessibility for iOS:
+
+- [Accessible design on iOS](https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/accessibility/)
+- [Accessible development on iOS](https://developer.apple.com/accessibility/ios/)
+
+<!-- /content-for -->
+
+<!-- content-for: web -->
+
+The stack component is for alignment only. It does not provide any structural information for assistive technologies. To convey relationships between specific items, consider using the [list component](https://polaris.shopify.com/components/lists-and-tables/list).
+
+<!-- /content-for -->

From ccd8336841d0e9f4bff85a7f4629277aa3c3e0e9 Mon Sep 17 00:00:00 2001
From: Devon Persing <devon.persing@shopify.com>
Date: Wed, 24 Apr 2019 15:26:53 -0700
Subject: [PATCH 2/4] Fixed relative URL

---
 src/components/Stack/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/Stack/README.md b/src/components/Stack/README.md
index a2818acd2a0..38bb0a5bceb 100644
--- a/src/components/Stack/README.md
+++ b/src/components/Stack/README.md
@@ -185,6 +185,6 @@ See Apple’s Human Interface Guidelines and API documentation about accessibili
 
 <!-- content-for: web -->
 
-The stack component is for alignment only. It does not provide any structural information for assistive technologies. To convey relationships between specific items, consider using the [list component](https://polaris.shopify.com/components/lists-and-tables/list).
+The stack component is for alignment only. It does not provide any structural information for assistive technologies. To convey relationships between specific items, consider using the [list component](/components/lists-and-tables/list).
 
 <!-- /content-for -->

From 0e7df89d2e1204e49131d94c62c408b9e5d2b33a Mon Sep 17 00:00:00 2001
From: Devon Persing <devon.persing@shopify.com>
Date: Wed, 24 Apr 2019 15:30:30 -0700
Subject: [PATCH 3/4] Added entry for doc updates

---
 UNRELEASED.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/UNRELEASED.md b/UNRELEASED.md
index dbcebc9e7e9..07e260e615d 100644
--- a/UNRELEASED.md
+++ b/UNRELEASED.md
@@ -24,6 +24,7 @@ Use [the changelog guidelines](https://git.io/polaris-changelog-guidelines) to f
 - Added accessibility documentation for `VisuallyHidden`. ([#1348](https://github.com/Shopify/polaris-react/pull/1348))
 - Added accessibility documentation for `TextStyle`. ([#1350](https://github.com/Shopify/polaris-react/pull/1350))
 - Added accessibility guidance for `Heading` and `Subheading`. ([#1351](https://github.com/Shopify/polaris-react/pull/1351))
+- Added accessibility documentation for `List` and `Stack`. ([#1353](https://github.com/Shopify/polaris-react/pull/1353))
 
 ### Development workflow
 

From 38fc5d297352dec646db8075e01318c41d8a5a9b Mon Sep 17 00:00:00 2001
From: Sadie Redden <sadie.redden@shopify.com>
Date: Thu, 25 Apr 2019 05:45:31 -1000
Subject: [PATCH 4/4] Update src/components/Stack/README.md

Co-Authored-By: dpersing <devon.persing@shopify.com>
---
 src/components/Stack/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/Stack/README.md b/src/components/Stack/README.md
index 38bb0a5bceb..4dfaf42d2b6 100644
--- a/src/components/Stack/README.md
+++ b/src/components/Stack/README.md
@@ -185,6 +185,6 @@ See Apple’s Human Interface Guidelines and API documentation about accessibili
 
 <!-- content-for: web -->
 
-The stack component is for alignment only. It does not provide any structural information for assistive technologies. To convey relationships between specific items, consider using the [list component](/components/lists-and-tables/list).
+The stack component is for alignment only and doesn’t provide any structural information for assistive technologies. To convey relationships between specific items, consider using the [list component](/components/lists-and-tables/list).
 
 <!-- /content-for -->