(DOCSP-11066): Explain why users need to allow keychain access for connections (#277)

Author: jeff-allen-mongo

source/connect/favorite-connections.txt

@@ -16,6 +16,10 @@ Favorite Connections
 easily reconnect to the same MongoDB deployment using the same
 specifications.
 
+.. note::
+
+   .. include:: /includes/fact-connection-keychain-access.rst
+
 Save a Favorite Connection
 --------------------------
 

source/includes/fact-connection-keychain-access.rst

@@ -0,0 +1,4 @@
+On macOS systems, the first time that you update |compass| to version
+1.20 or later, you will need to allow access to your system storage
+**for each** saved connection in :guilabel:`Recents` and
+:guilabel:`Favorites`. To learn more, see :ref:`keychain-access`.

source/release-notes.txt

@@ -30,6 +30,10 @@ Release Notes
 |compass| 1.20
 --------------
 
+.. note::
+
+   .. include:: /includes/fact-connection-keychain-access.rst
+
 *Released December 5, 2019*
 
 - Added the option to include driver syntax when
@@ -69,13 +73,6 @@ Release Notes
 
 - Various bug fixes and improvements.
 
-.. note::
-
-   When you update |compass| to version 1.20, you will need to allow 
-   access to your system storage for each item in :guilabel:`Recents` 
-   and :guilabel:`Favorites`. This should be the last update that 
-   requires you to enter your keychain password.
-
 |compass| 1.19
 --------------
 

source/upgrade.txt

@@ -1,8 +1,8 @@
 .. _upgrade-compass:
 
-=======================
-Upgrade MongoDB Compass
-=======================
+======================
+Update MongoDB Compass
+======================
 
 .. default-domain:: mongodb
 
@@ -48,6 +48,21 @@ You can enable automatic updates to the latest version of Compass on the
 Instead, |compass-short| prompts you to upgrade when a new version is
 available.
 
+.. _keychain-access:
+
+Allow Keychain Access for Recent and Favorite Connections
+---------------------------------------------------------
+
+On macOS systems, the first time that you update |compass| to version
+1.20 or later, you will need to allow access to your system storage
+**for each** saved connection in :guilabel:`Recents` and
+:guilabel:`Favorites`.
+
+When prompted for your keychain password, click :guilabel:`Always Allow`
+to prevent being prompted for your password in the future. This
+ensures |compass| has access to your saved connections when updating
+to new versions.
+
 .. _migrate-from-community:
 
 Migrate to Compass from Compass Community