diff --git a/include/git2/proxy.h b/include/git2/proxy.h
index 195ab75e099..fc8ffaaa8ee 100644
--- a/include/git2/proxy.h
+++ b/include/git2/proxy.h
@@ -70,9 +70,8 @@ typedef struct {
 	git_credential_acquire_cb credentials;
 
 	/**
-	 * If cert verification fails, this will be called to let the
-	 * user make the final decision of whether to allow the
-	 * connection to proceed. Returns 0 to allow the connection
+	 * This will be called to let the user make the final decision of whether
+	 * to allow the connection to proceed. Returns 0 to allow the connection
 	 * or a negative value to indicate an error.
 	 */
 	git_transport_certificate_check_cb certificate_check;
diff --git a/include/git2/remote.h b/include/git2/remote.h
index 2472dedccf8..b8fa0218456 100644
--- a/include/git2/remote.h
+++ b/include/git2/remote.h
@@ -596,9 +596,8 @@ struct git_remote_callbacks {
 	git_credential_acquire_cb credentials;
 
 	/**
-	 * If cert verification fails, this will be called to let the
-	 * user make the final decision of whether to allow the
-	 * connection to proceed. Returns 0 to allow the connection
+	 * This will be called to let the user make the final decision of whether
+	 * to allow the connection to proceed. Returns 0 to allow the connection
 	 * or a negative value to indicate an error.
 	 */
 	git_transport_certificate_check_cb certificate_check;