docs: revise MKP examples intro

Author: mattsb42-aws

examples/src/master_key_provider/aws_kms/discovery_decrypt.py

@@ -1,8 +1,8 @@
 # Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 """
-This example is provided as a reference for users migrating away from master key providers.
-We recommend that all new use should use keyrings.
+This example is intended to serve as reference material for users migrating away from master key providers.
+We recommend using keyrings rather than master key providers.
 For examples using keyrings, see the ``examples/src/keyrings`` directory.
 
 The KMS master key provider uses any key IDs that you specify on encrypt,

examples/src/master_key_provider/aws_kms/multiple_regions.py

@@ -1,8 +1,8 @@
 # Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 """
-This example is provided as a reference for users migrating away from master key providers.
-We recommend that all new use should use keyrings.
+This example is intended to serve as reference material for users migrating away from master key providers.
+We recommend using keyrings rather than master key providers.
 For examples using keyrings, see the ``examples/src/keyrings`` directory.
 
 This example shows how to configure and use a KMS master key provider with with CMKs in multiple regions.

examples/src/master_key_provider/aws_kms/single_cmk.py

@@ -1,8 +1,8 @@
 # Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 """
-This example is provided as a reference for users migrating away from master key providers.
-We recommend that all new use should use keyrings.
+This example is intended to serve as reference material for users migrating away from master key providers.
+We recommend using keyrings rather than master key providers.
 For examples using keyrings, see the ``examples/src/keyrings`` directory.
 
 This example shows how to configure and use a KMS master key with a single KMS CMK.

examples/src/master_key_provider/multi/aws_kms_with_escrow.py

@@ -1,8 +1,8 @@
 # Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 """
-This example is provided as a reference for users migrating away from master key providers.
-We recommend that all new use should use keyrings.
+This example is intended to serve as reference material for users migrating away from master key providers.
+We recommend using keyrings rather than master key providers.
 For examples using keyrings, see the ``examples/src/keyrings`` directory.
 
 One use-case that we have seen customers need is

examples/src/master_key_provider/raw_aes/raw_aes.py

@@ -1,8 +1,8 @@
 # Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 """
-This example is provided as a reference for users migrating away from master key providers.
-We recommend that all new use should use keyrings.
+This example is intended to serve as reference material for users migrating away from master key providers.
+We recommend using keyrings rather than master key providers.
 For examples using keyrings, see the ``examples/src/keyrings`` directory.
 
 This examples shows how to configure and use a raw AES master key.

examples/src/master_key_provider/raw_rsa/private_key_only_from_pem.py

@@ -1,8 +1,8 @@
 # Copyright Amazon.com Inc. or its affiliates. All Rights Reserved.
 # SPDX-License-Identifier: Apache-2.0
 """
-This example is provided as a reference for users migrating away from master key providers.
-We recommend that all new use should use keyrings.
+This example is intended to serve as reference material for users migrating away from master key providers.
+We recommend using keyrings rather than master key providers.
 For examples using keyrings, see the ``examples/src/keyrings`` directory.
 
 This example shows how to configure and use a raw RSA master key using a PEM-encoded RSA private key.