From 54415fb69dee85df4d88c336d3f64697eff9c4a2 Mon Sep 17 00:00:00 2001
From: Emil Lundberg <emil@yubico.com>
Date: Thu, 31 Jan 2019 13:06:07 +0100
Subject: [PATCH] Reword documentation based on tech writer review

---
 .../webauthn/attestation/StandardMetadataService.java       | 4 ++--
 .../java/com/yubico/webauthn/attestation/TrustResolver.java | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/StandardMetadataService.java b/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/StandardMetadataService.java
index 5bfbdd251..129eb699e 100644
--- a/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/StandardMetadataService.java
+++ b/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/StandardMetadataService.java
@@ -105,8 +105,8 @@ public Attestation getCachedAttestation(String attestationCertificateFingerprint
      *
      * <p>
      * If the certificate chain is not trusted, the method returns an untrusted
-     * attestation populated with transports information found embedded in the
-     * attestation certificate.
+     * attestation populated with {@link Attestation#getTransports() transports}
+     * information found embedded in the attestation certificate.
      * </p>
      *
      * <p>
diff --git a/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/TrustResolver.java b/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/TrustResolver.java
index 5a6b62c0d..105fce61a 100644
--- a/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/TrustResolver.java
+++ b/webauthn-server-attestation/src/main/java/com/yubico/webauthn/attestation/TrustResolver.java
@@ -46,9 +46,9 @@ default Optional<X509Certificate> resolveTrustAnchor(X509Certificate attestation
      * @param attestationCertificate The attestation certificate
      * @param caCertificateChain Zero or more certificates, of which the first
      *          has signed <code>attestationCertificate</code> and each of the
-     *          rest has signed the previous in order
-     * @return A trusted root certificate from which there exists a signature
-     *          path to <code>attestationCertificate</code>, if one exists.
+     *          remaining certificates has signed the certificate preceding it.
+     * @return A trusted root certificate from which there is a signature path
+     *          to <code>attestationCertificate</code>, if one exists.
      */
     Optional<X509Certificate> resolveTrustAnchor(X509Certificate attestationCertificate, List<X509Certificate> caCertificateChain);