docs: code documentation improvements

google-cloud-kms-v1/lib/google/cloud/kms/v1/autokey/client.rb

@@ -262,9 +262,9 @@ def logger
             # Creates a new {::Google::Cloud::Kms::V1::KeyHandle KeyHandle}, triggering the
             # provisioning of a new {::Google::Cloud::Kms::V1::CryptoKey CryptoKey} for CMEK
             # use with the given resource type in the configured key project and the same
-            # location. [GetOperation][Operations.GetOperation] should be used to resolve
-            # the resulting long-running operation and get the resulting
-            # {::Google::Cloud::Kms::V1::KeyHandle KeyHandle} and
+            # location. GetOperation should
+            # be used to resolve the resulting long-running operation and get the
+            # resulting {::Google::Cloud::Kms::V1::KeyHandle KeyHandle} and
             # {::Google::Cloud::Kms::V1::CryptoKey CryptoKey}.
             #
             # @overload create_key_handle(request, options = nil)

google-cloud-kms-v1/lib/google/cloud/kms/v1/autokey/rest/client.rb

@@ -257,9 +257,9 @@ def logger
               # Creates a new {::Google::Cloud::Kms::V1::KeyHandle KeyHandle}, triggering the
               # provisioning of a new {::Google::Cloud::Kms::V1::CryptoKey CryptoKey} for CMEK
               # use with the given resource type in the configured key project and the same
-              # location. [GetOperation][Operations.GetOperation] should be used to resolve
-              # the resulting long-running operation and get the resulting
-              # {::Google::Cloud::Kms::V1::KeyHandle KeyHandle} and
+              # location. GetOperation should
+              # be used to resolve the resulting long-running operation and get the
+              # resulting {::Google::Cloud::Kms::V1::KeyHandle KeyHandle} and
               # {::Google::Cloud::Kms::V1::CryptoKey CryptoKey}.
               #
               # @overload create_key_handle(request, options = nil)

google-cloud-kms-v1/lib/google/cloud/kms/v1/key_management_service/client.rb

@@ -1585,7 +1585,9 @@ def create_crypto_key_version request, options = nil
             #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion}, the
             #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion} must be a child of
             #     {::Google::Cloud::Kms::V1::ImportCryptoKeyVersionRequest#parent ImportCryptoKeyVersionRequest.parent},
-            #     have been previously created via [ImportCryptoKeyVersion][], and be in
+            #     have been previously created via
+            #     {::Google::Cloud::Kms::V1::KeyManagementService::Client#import_crypto_key_version ImportCryptoKeyVersion},
+            #     and be in
             #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::DESTROYED DESTROYED}
             #     or
             #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::IMPORT_FAILED IMPORT_FAILED}
@@ -3340,7 +3342,8 @@ def mac_sign request, options = nil
             #     checksum. {::Google::Cloud::Kms::V1::KeyManagementService::Client KeyManagementService}
             #     will report an error if the checksum verification fails. If you receive a
             #     checksum error, your client should verify that
-            #     CRC32C([MacVerifyRequest.tag][]) is equal to
+            #     CRC32C({::Google::Cloud::Kms::V1::MacVerifyRequest#mac MacVerifyRequest.mac}) is
+            #     equal to
             #     {::Google::Cloud::Kms::V1::MacVerifyRequest#mac_crc32c MacVerifyRequest.mac_crc32c},
             #     and if so, perform a limited number of retries. A persistent mismatch may
             #     indicate an issue in your computation of the CRC32C checksum. Note: This

google-cloud-kms-v1/lib/google/cloud/kms/v1/key_management_service/rest/client.rb

@@ -1496,7 +1496,9 @@ def create_crypto_key_version request, options = nil
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion}, the
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion} must be a child of
               #     {::Google::Cloud::Kms::V1::ImportCryptoKeyVersionRequest#parent ImportCryptoKeyVersionRequest.parent},
-              #     have been previously created via [ImportCryptoKeyVersion][], and be in
+              #     have been previously created via
+              #     {::Google::Cloud::Kms::V1::KeyManagementService::Rest::Client#import_crypto_key_version ImportCryptoKeyVersion},
+              #     and be in
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::DESTROYED DESTROYED}
               #     or
               #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::IMPORT_FAILED IMPORT_FAILED}
@@ -3153,7 +3155,8 @@ def mac_sign request, options = nil
               #     checksum. {::Google::Cloud::Kms::V1::KeyManagementService::Rest::Client KeyManagementService}
               #     will report an error if the checksum verification fails. If you receive a
               #     checksum error, your client should verify that
-              #     CRC32C([MacVerifyRequest.tag][]) is equal to
+              #     CRC32C({::Google::Cloud::Kms::V1::MacVerifyRequest#mac MacVerifyRequest.mac}) is
+              #     equal to
               #     {::Google::Cloud::Kms::V1::MacVerifyRequest#mac_crc32c MacVerifyRequest.mac_crc32c},
               #     and if so, perform a limited number of retries. A persistent mismatch may
               #     indicate an issue in your computation of the CRC32C checksum. Note: This

google-cloud-kms-v1/proto_docs/google/cloud/kms/v1/ekm_service.rb

@@ -192,7 +192,7 @@ class Certificate
         # {::Google::Cloud::Kms::V1::CryptoKey CryptoKeys} and
         # {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersions} with a
         # {::Google::Cloud::Kms::V1::ProtectionLevel ProtectionLevel} of
-        # [EXTERNAL_VPC][CryptoKeyVersion.ProtectionLevel.EXTERNAL_VPC], as well as
+        # {::Google::Cloud::Kms::V1::ProtectionLevel::EXTERNAL_VPC EXTERNAL_VPC}, as well as
         # performing cryptographic operations using keys created within the
         # {::Google::Cloud::Kms::V1::EkmConnection EkmConnection}.
         # @!attribute [r] name
@@ -286,6 +286,7 @@ module KeyManagementMode
             # All {::Google::Cloud::Kms::V1::CryptoKey CryptoKeys} created with this
             # {::Google::Cloud::Kms::V1::EkmConnection EkmConnection} use EKM-side key
             # management operations initiated from Cloud KMS. This means that:
+            #
             # * When a {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion}
             # associated with this {::Google::Cloud::Kms::V1::EkmConnection EkmConnection}
             # is
@@ -294,7 +295,8 @@ module KeyManagementMode
             #   external key material.
             # * Destruction of external key material associated with this
             #   {::Google::Cloud::Kms::V1::EkmConnection EkmConnection} can be requested by
-            #   calling [DestroyCryptoKeyVersion][EkmService.DestroyCryptoKeyVersion].
+            #   calling
+            #   {::Google::Cloud::Kms::V1::KeyManagementService::Client#destroy_crypto_key_version DestroyCryptoKeyVersion}.
             # * Automatic rotation of key material is supported.
             CLOUD_KMS = 2
           end
@@ -305,7 +307,7 @@ module KeyManagementMode
         # {::Google::Cloud::Kms::V1::CryptoKey CryptoKeys} and
         # {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersions} with a
         # {::Google::Cloud::Kms::V1::ProtectionLevel ProtectionLevel} of
-        # [EXTERNAL_VPC][CryptoKeyVersion.ProtectionLevel.EXTERNAL_VPC] in a given
+        # {::Google::Cloud::Kms::V1::ProtectionLevel::EXTERNAL_VPC EXTERNAL_VPC} in a given
         # project and location.
         # @!attribute [r] name
         #   @return [::String]

google-cloud-kms-v1/proto_docs/google/cloud/kms/v1/resources.rb

@@ -133,7 +133,7 @@ class KeyRing
         #     where all related cryptographic operations are performed. Only applicable
         #     if {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersions} have a
         #     {::Google::Cloud::Kms::V1::ProtectionLevel ProtectionLevel} of
-        #     [EXTERNAL_VPC][CryptoKeyVersion.ProtectionLevel.EXTERNAL_VPC], with the
+        #     {::Google::Cloud::Kms::V1::ProtectionLevel::EXTERNAL_VPC EXTERNAL_VPC}, with the
         #     resource name in the format `projects/*/locations/*/ekmConnections/*`.
         #     Note, this list is non-exhaustive and may apply to additional
         #     {::Google::Cloud::Kms::V1::ProtectionLevel ProtectionLevels} in the future.

google-cloud-kms-v1/proto_docs/google/cloud/kms/v1/service.rb

@@ -393,7 +393,9 @@ class CreateCryptoKeyVersionRequest
         #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion}, the
         #     {::Google::Cloud::Kms::V1::CryptoKeyVersion CryptoKeyVersion} must be a child of
         #     {::Google::Cloud::Kms::V1::ImportCryptoKeyVersionRequest#parent ImportCryptoKeyVersionRequest.parent},
-        #     have been previously created via [ImportCryptoKeyVersion][], and be in
+        #     have been previously created via
+        #     {::Google::Cloud::Kms::V1::KeyManagementService::Client#import_crypto_key_version ImportCryptoKeyVersion},
+        #     and be in
         #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::DESTROYED DESTROYED}
         #     or
         #     {::Google::Cloud::Kms::V1::CryptoKeyVersion::CryptoKeyVersionState::IMPORT_FAILED IMPORT_FAILED}
@@ -1065,7 +1067,8 @@ class MacSignRequest
         #     checksum. {::Google::Cloud::Kms::V1::KeyManagementService::Client KeyManagementService}
         #     will report an error if the checksum verification fails. If you receive a
         #     checksum error, your client should verify that
-        #     CRC32C([MacVerifyRequest.tag][]) is equal to
+        #     CRC32C({::Google::Cloud::Kms::V1::MacVerifyRequest#mac MacVerifyRequest.mac}) is
+        #     equal to
         #     {::Google::Cloud::Kms::V1::MacVerifyRequest#mac_crc32c MacVerifyRequest.mac_crc32c},
         #     and if so, perform a limited number of retries. A persistent mismatch may
         #     indicate an issue in your computation of the CRC32C checksum. Note: This