fix

Author: RitvikKapila

examples/src/migration/README.rst

@@ -7,16 +7,13 @@ level cryptographic materials management of encryption and decryption materials.
 
 This directory contains migration examples for:
 
-* Moving to Keyrings from Master Key Providers:
-    #. Migration example to AWS KMS keyring from AWS KMS Master Key Provider.
-    #. Migration example to Raw AES keyring from Raw AES Master Key Provider.
-    #. Migration example to Raw RSA keyring from Raw RSA Master Key Provider.
+#. Moving to Keyrings from Master Key Providers:
+    * Migration example to AWS KMS keyring from AWS KMS Master Key Provider.
+    * Migration example to Raw AES keyring from Raw AES Master Key Provider.
+    * Migration example to Raw RSA keyring from Raw RSA Master Key Provider.
 
-* Migration to newer versions of the ESDK from the old version (1.x):
-    #. Setting a 'CommitmentPolicy' during migration.
-    If you have messages encrypted in the older versions of the ESDK (1.x),
-    this example can guide you on how to decrypt those messages using the
-    new version of the ESDK.
+#. Migration to newer versions of the ESDK (4.x+) from 1.x versions:
+    * Setting a 'CommitmentPolicy' during migration - If you have messages encrypted with 1.x versions of the ESDK (i.e. not using key commitment) and want to migrate to encrypt with key commitment using the keyring providers introduced in ESDK 4.x, this example will guide you on how to decrypt those messages using the new version of the ESDK.
 
 .. _AWS Cryptographic Material Providers Library: https://github.com/aws/aws-cryptographic-material-providers-library
 .. _Encryption SDK for Python: https://github.com/aws/aws-encryption-sdk-python/tree/9c34aad60fc918c1a9186ec5215a451e8bfd0f65

examples/src/migration/migration_raw_aes_key_example.py

@@ -19,7 +19,7 @@
 
 Note: The ciphertexts obtained by encrypting EXAMPLE_DATA using keyring and MKP are not
 the same because the ESDK generates different data keys each time for encryption of the data.
-But both ciphertexts when decrypted using keyring and MKP should give the same plaintext result.
+But both ciphertexts when decrypted using keyring and MKP will give the same plaintext result.
 
 For more information on how to use Raw AES keyrings, see
 https://docs.aws.amazon.com/encryption-sdk/latest/developer-guide/use-raw-aes-keyring.html
@@ -172,7 +172,7 @@ def migration_raw_aes_key():
     # Note: The ciphertexts obtained by encrypting EXAMPLE_DATA using keyring and MKP
     # (that is ciphertext_keyring and ciphertext_mkp) are not the same because the ESDK
     # generates different data keys each time for encryption of the data. But both
-    # ciphertexts when decrypted using keyring and MKP should give the same plaintext result.
+    # ciphertexts when decrypted using keyring and MKP will give the same plaintext result.
 
     # 3. Decrypt the ciphertext_keyring using both the keyring and MKP and ensure the
     # resulting plaintext is the same and also equal to EXAMPLE_DATA

examples/src/migration/migration_raw_rsa_key_example.py

@@ -23,7 +23,7 @@
 
 Note: The ciphertexts obtained by encrypting EXAMPLE_DATA using keyring and MKP are not
 the same because the ESDK generates different data keys each time for encryption of the data.
-But both ciphertexts when decrypted using keyring and MKP should give the same plaintext result.
+But both ciphertexts when decrypted using keyring and MKP will give the same plaintext result.
 
 For more information on how to use Raw RSA keyrings, see
 https://docs.aws.amazon.com/encryption-sdk/latest/developer-guide/use-raw-rsa-keyring.html
@@ -224,7 +224,7 @@ def migration_raw_rsa_key(
     # Note: The ciphertexts obtained by encrypting EXAMPLE_DATA using keyring and MKP
     # (that is ciphertext_keyring and ciphertext_mkp) are not the same because the ESDK
     # generates different data keys each time for encryption of the data. But both
-    # ciphertexts when decrypted using keyring and MKP should give the same plaintext result.
+    # ciphertexts when decrypted using keyring and MKP will give the same plaintext result.
 
     # 3. Decrypt the ciphertext_keyring using both the keyring and MKP and ensure the
     # resulting plaintext is the same and also equal to EXAMPLE_DATA