From b0645c91a9c514917140437e6341a8c813b43cce Mon Sep 17 00:00:00 2001
From: Devon Persing <devon.persing@shopify.com>
Date: Mon, 4 Feb 2019 14:01:46 -0800
Subject: [PATCH 1/4] Added guidelines for setting toggle and account
 connection

---
 src/components/AccountConnection/README.md | 10 ++++++++++
 src/components/SettingToggle/README.md     | 12 ++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/src/components/AccountConnection/README.md b/src/components/AccountConnection/README.md
index c0b0358c2dc..7fc6c822280 100644
--- a/src/components/AccountConnection/README.md
+++ b/src/components/AccountConnection/README.md
@@ -166,3 +166,13 @@ class AccountConnectionExample extends React.Component {
   };
 }
 ```
+
+---
+
+## Accessibility
+
+<!-- content-for: web -->
+
+The account connection component relies on the [setting toggle component](/components/actions/setting-toggle) to turn connections on and off.
+
+<!-- /content-for-->
diff --git a/src/components/SettingToggle/README.md b/src/components/SettingToggle/README.md
index 109a5c03b4c..2793ae6fec5 100644
--- a/src/components/SettingToggle/README.md
+++ b/src/components/SettingToggle/README.md
@@ -115,3 +115,15 @@ class SettingToggleExample extends React.Component {
 ## Related components
 
 - To let merchants to connect or disconnect their store to third-party services and apps, [use the account connection component](/components/actions/account-connection)
+
+---
+
+## Accessibility
+
+<!-- content-for: web -->
+
+The setting toggle component is implemented as an HTML `<button>`. The current label should convey what will happen when the button is pressed.
+
+To learn more about button accessibility, see the [button component](/components/actions/button).
+
+<!-- /content-for-->

From fafef268628c12be6485e61c492293da3b443b11 Mon Sep 17 00:00:00 2001
From: Devon Persing <devon.persing@shopify.com>
Date: Mon, 4 Feb 2019 14:05:57 -0800
Subject: [PATCH 2/4] Changed language in context

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

diff --git a/src/components/AccountConnection/README.md b/src/components/AccountConnection/README.md
index 7fc6c822280..d0ee745af26 100644
--- a/src/components/AccountConnection/README.md
+++ b/src/components/AccountConnection/README.md
@@ -173,6 +173,6 @@ class AccountConnectionExample extends React.Component {
 
 <!-- content-for: web -->
 
-The account connection component relies on the [setting toggle component](/components/actions/setting-toggle) to turn connections on and off.
+See accessibility guidance for the [setting toggle component](/components/actions/setting-toggle) to turn connections on and off.
 
 <!-- /content-for-->

From 2a13be1b03a9494e81612cfc271887fce60cf9ee Mon Sep 17 00:00:00 2001
From: Devon Persing <devon.persing@shopify.com>
Date: Mon, 4 Feb 2019 14:17:11 -0800
Subject: [PATCH 3/4] Added entry for updates

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

diff --git a/UNRELEASED.md b/UNRELEASED.md
index f69a9ac6233..458e13ec774 100644
--- a/UNRELEASED.md
+++ b/UNRELEASED.md
@@ -16,6 +16,8 @@ Use [the changelog guidelines](https://git.io/polaris-changelog-guidelines) to f
 
 ### Documentation
 
+- Added accessibility documentation for the account connection and setting toggle components ([#970](https://github.com/Shopify/polaris-react/pull/970))
+
 ### Development workflow
 
 ### Dependency upgrades

From af0683cc36d7edb5f4ee76c954e3cc091cbf30f6 Mon Sep 17 00:00:00 2001
From: Sadie Redden <sadie.redden@shopify.com>
Date: Wed, 6 Feb 2019 12:45:22 -0800
Subject: [PATCH 4/4] Update src/components/SettingToggle/README.md

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

diff --git a/src/components/SettingToggle/README.md b/src/components/SettingToggle/README.md
index 2793ae6fec5..ed9cbb0d3bd 100644
--- a/src/components/SettingToggle/README.md
+++ b/src/components/SettingToggle/README.md
@@ -122,7 +122,7 @@ class SettingToggleExample extends React.Component {
 
 <!-- content-for: web -->
 
-The setting toggle component is implemented as an HTML `<button>`. The current label should convey what will happen when the button is pressed.
+The setting toggle component is implemented as an HTML `<button>`. The current label should convey what happens when the button is pressed.
 
 To learn more about button accessibility, see the [button component](/components/actions/button).