diff --git a/maven-artifact/src/main/java/org/apache/maven/artifact/handler/ArtifactHandler.java b/maven-artifact/src/main/java/org/apache/maven/artifact/handler/ArtifactHandler.java
index 51c7c51d2c9a..89f59bdb284e 100644
--- a/maven-artifact/src/main/java/org/apache/maven/artifact/handler/ArtifactHandler.java
+++ b/maven-artifact/src/main/java/org/apache/maven/artifact/handler/ArtifactHandler.java
@@ -19,10 +19,10 @@
package org.apache.maven.artifact.handler;
/**
- * An artifact handler defines for a dependency type, defined as Plexus role:
- * - extension and classifier, to be able to download the file,
- * - information on how to use the artifact: whether to add it to the classpath, or to take into account its
- * dependencies.
+ * An artifact handler contains information explaining how an artifact plugs into the Maven build:
+ * - Information needed to find the artifact file in a repository including extension and classifier
+ * - Information on how to use the artifact as a dependency: whether to add it to the classpath, whether to load its
+ * dependencies transitively
*
*
* @author Jason van Zyl
@@ -32,7 +32,8 @@ public interface ArtifactHandler {
String ROLE = ArtifactHandler.class.getName();
/**
- * Get the file extension associated to the file represented by the dependency type.
+ * Returns the file name extension of the artifact;
+ * e.g. "jar", "pom", "xml", etc.
*
* @return the file extension
*/
@@ -41,7 +42,7 @@ public interface ArtifactHandler {
String getDirectory();
/**
- * Get the classifier associated to the dependency type.
+ * Returns the default classifier used if a different one is not set in pom.xml.
*
* @return the classifier
*/