improved javaDocs (#587)

Author: timea-solid

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 {
 

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 -> {