diff --git a/api/src/main/java/org/apache/iceberg/io/CredentialSupplier.java b/api/src/main/java/org/apache/iceberg/io/CredentialSupplier.java
index cd7f601770b0..4211306f3041 100644
--- a/api/src/main/java/org/apache/iceberg/io/CredentialSupplier.java
+++ b/api/src/main/java/org/apache/iceberg/io/CredentialSupplier.java
@@ -28,7 +28,7 @@
  */
 public interface CredentialSupplier {
   /**
-   * @return the credential string
+   * Returns the credential string
    */
   String getCredential();
 }
diff --git a/api/src/main/java/org/apache/iceberg/io/FileIO.java b/api/src/main/java/org/apache/iceberg/io/FileIO.java
index 187b53fa2a0f..9b301116ab8f 100644
--- a/api/src/main/java/org/apache/iceberg/io/FileIO.java
+++ b/api/src/main/java/org/apache/iceberg/io/FileIO.java
@@ -62,7 +62,7 @@ default void deleteFile(OutputFile file) {
   }
 
   /**
-   * @return the property map used to configure this FileIO
+   * Returns the property map used to configure this FileIO
    * @throws UnsupportedOperationException if this FileIO does not expose its configuration properties
    */
   default Map<String, String> properties() {