chore: address comments from technical writers (#528)

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://togithub.com/googleapis/python-bigquery-dataframes/issues/new/choose) before writing your code!  That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)

Fixes internal #325274012 🦕

Author: ashleyxuu

bigframes/_config/bigquery_options.py

@@ -56,7 +56,8 @@ def __init__(
     def application_name(self) -> Optional[str]:
         """The application name to amend to the user-agent sent to Google APIs.
 
-        Recommended format is ``"appplication-name/major.minor.patch_version"``
+        The application name to amend to the user agent sent to Google APIs.
+        The recommended format is  ``"appplication-name/major.minor.patch_version"``
         or ``"(gpn:PartnerName;)"`` for official Google partners.
         """
         return self._application_name
@@ -71,7 +72,7 @@ def application_name(self, value: Optional[str]):
 
     @property
     def credentials(self) -> Optional[google.auth.credentials.Credentials]:
-        """The OAuth2 Credentials to use for this client."""
+        """The OAuth2 credentials to use for this client."""
         return self._credentials
 
     @credentials.setter
@@ -84,7 +85,7 @@ def credentials(self, value: Optional[google.auth.credentials.Credentials]):
     def location(self) -> Optional[str]:
         """Default location for job, datasets, and tables.
 
-        See: https://cloud.google.com/bigquery/docs/locations
+        For more information, see https://cloud.google.com/bigquery/docs/locations BigQuery locations.
         """
         return self._location
 
@@ -107,13 +108,15 @@ def project(self, value: Optional[str]):
 
     @property
     def bq_connection(self) -> Optional[str]:
-        """Name of the BigQuery connection to use. Should be of the form
+        """Name of the BigQuery connection to use in the form
         <PROJECT_NUMBER/PROJECT_ID>.<LOCATION>.<CONNECTION_ID>.
 
-        You should either have the connection already created in the
-        <code>location</code> you have chosen, or you should have the Project IAM
-        Admin role to enable the service to create the connection for you if you
-        need it.
+        You either need to create the connection in a location of your choice, or
+        you need the Project Admin IAM role to enable the service to create the
+        connection for you.
+
+        If this option isn't available, or the project or location isn't provided,
+        then the default connection project/location/connection_id is used in the session.
 
         If this option isn't provided, or project or location aren't provided,
         session will use its default project/location/connection_id as default connection.
@@ -151,12 +154,12 @@ def use_regional_endpoints(self) -> bool:
         """Flag to connect to regional API endpoints.
 
         .. deprecated:: 0.13.0
-            Use of regional endpoints is a feature in preview and
+            Use of regional endpoints is a feature in Preview and
             available only in selected regions and projects.
 
-        Requires ``location`` to also be set. For example, set
-        ``location='asia-northeast1'`` and ``use_regional_endpoints=True`` to
-        connect to asia-northeast1-bigquery.googleapis.com.
+        Requires that ``location`` is set. For example, to connect to
+        asia-northeast1-bigquery.googleapis.com, specify
+        ``location='asia-northeast1'`` and ``use_regional_endpoints=True``.
         """
         return self._use_regional_endpoints
 
@@ -177,17 +180,22 @@ def use_regional_endpoints(self, value: bool):
 
     @property
     def kms_key_name(self) -> Optional[str]:
-        """Customer managed encryption key used to control encryption of the
+        """
+        Customer-managed encryption key
+        used to control encryption of the data at rest in BigQuery. This key
+        takes the format projects/PROJECT_ID/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
+
+        Customer managed encryption key used to control encryption of the
         data-at-rest in BigQuery. This is of the format
         projects/PROJECT_ID/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY
 
-        See https://cloud.google.com/bigquery/docs/customer-managed-encryption
-        for more details.
+        For more information, see https://cloud.google.com/bigquery/docs/customer-managed-encryption
+        Customer-managed Cloud KMS keys
 
-        Please make sure the project used for Bigquery DataFrames has "Cloud KMS
-        CryptoKey Encrypter/Decrypter" role in the key's project, See
-        https://cloud.google.com/bigquery/docs/customer-managed-encryption#assign_role
-        for steps on how to ensure that.
+        Make sure the project used for Bigquery DataFrames has the
+        Cloud KMS CryptoKey Encrypter/Decrypter IAM role in the key's project.
+        For more information, see https://cloud.google.com/bigquery/docs/customer-managed-encryption#assign_role
+        Assign the Encrypter/Decrypter.
         """
         return self._kms_key_name