desruisseaux commented on code in PR #1640:
URL: https://github.com/apache/maven/pull/1640#discussion_r1714911250
##########
api/maven-api-core/src/main/java/org/apache/maven/api/Artifact.java:
##########
@@ -23,76 +23,83 @@
import org.apache.maven.api.annotations.Nonnull;
/**
- * An artifact points to a resource such as a jar file or war application.
+ * Pointer to a resolved resource such as a <abbr>JAR</abbr> file or
<abbr>WAE</abbr> application.
+ * {@code Artifact} instances are created when <dfn>resolving</dfn> {@link
Artifact} instances.
+ * Resolving is the process that selects a {@linkplain #getVersion()
particular version}
+ * and downloads the artifact in the local repository.
Review Comment:
Added a "definitions of terms" section in `package-info.java` with the above
explanation about artifact resolution and dependency resolution. Since those
definitions include the download part, they answer my [previous
comment](https://github.com/apache/maven/pull/1640#discussion_r1714881957).
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscr...@maven.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
