From c3ae84d3e533dfecedaa0a1beb1c8ddae03f0b93 Mon Sep 17 00:00:00 2001
From: Timea Turdean <4144203+timea-solid@users.noreply.github.com>
Date: Mon, 10 Jul 2023 18:15:37 +0200
Subject: [PATCH] improved javaDocs

---
 .../client/accessgrant/AccessCredentialVerification.java       | 3 +++
 .../java/com/inrupt/client/accessgrant/AccessGrantClient.java  | 3 ++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessCredentialVerification.java b/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessCredentialVerification.java
index 084b42dae2e..05e247dd3de 100644
--- a/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessCredentialVerification.java
+++ b/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessCredentialVerification.java
@@ -25,6 +25,9 @@
 
 /**
  * The response from a verification operation.
+ * The response contains a list of performed checks, a list of errors and warning that might have occurred.
+ *
+ * @see <a href="https://docs.inrupt.com/ess/latest/services/service-access-grant-verifier/">Access Grant Service</a>
  */
 public class AccessCredentialVerification {
 
diff --git a/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessGrantClient.java b/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessGrantClient.java
index 6638c830492..664a63b8ad2 100644
--- a/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessGrantClient.java
+++ b/access-grant/src/main/java/com/inrupt/client/accessgrant/AccessGrantClient.java
@@ -343,7 +343,8 @@ public CompletionStage<AccessGrant> issue(final URI type, final URI recipient, f
      * Verify an access grant or request.
      *
      * @param credential the credential to verify
-     * @return the next stage of completion containing the verification result
+     * @return the next stage of completion containing the verification result in the form of a
+     * {@link AccessCredentialVerification}
      */
     public CompletionStage<AccessCredentialVerification> verify(final AccessCredential credential) {
         return v1Metadata().thenCompose(metadata -> {