diff --git a/maven-release-manager/src/main/java/org/apache/maven/shared/release/transform/ModelETL.java b/maven-release-manager/src/main/java/org/apache/maven/shared/release/transform/ModelETL.java
index b83ec64a..09f17843 100644
--- a/maven-release-manager/src/main/java/org/apache/maven/shared/release/transform/ModelETL.java
+++ b/maven-release-manager/src/main/java/org/apache/maven/shared/release/transform/ModelETL.java
@@ -51,11 +51,18 @@ public interface ModelETL {
      */
     void load(File pomFile) throws ReleaseExecutionException;
 
-    // will be removed once transform() is implemented
     /**
-     * <p>getModel.</p>
+     * Returns the intermediate {@link Model} representation.
      *
-     * @return a {@link org.apache.maven.model.Model} object
+     * @deprecated This method is a temporary accessor that exists only for
+     *             legacy workflow support. It will be removed once the
+     *             {@link #transform()} processing phase is fully implemented
+     *             and callers no longer need to access the intermediate model
+     *             directly.
+     *
+     *             There is no direct replacement. New code should rely on the
+     *             {@link #extract(File)} -> {@link #transform()} -> {@link #load(File)}
+     *             processing pipeline instead of accessing the model explicitly.
      */
     @Deprecated
     Model getModel();
diff --git a/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PerformReleaseMojo.java b/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PerformReleaseMojo.java
index ccc303d1..fa23214f 100644
--- a/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PerformReleaseMojo.java
+++ b/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PerformReleaseMojo.java
@@ -86,15 +86,10 @@ public class PerformReleaseMojo extends AbstractScmReadReleaseMojo {
     private boolean localCheckout;
 
     /**
-     * Whether to use the default release profile (Maven 2 and 3) that adds sources and javadocs to the released
-     * artifact, if appropriate. If set to true, the release plugin sets the property "<code>performRelease</code>" to
-     * true, which activates the profile "<code>release-profile</code>" as inherited from
-     * <a href="/ref/3.8.5/maven-model-builder/super-pom.html">the super pom</a>.
-     *
-     * @deprecated The <code>release-profile</code> profile will be removed from future versions of the super POM
+     * Whether to use the default {@code release-profile} from the Maven super POM, which adds sources and javadocs to the released artifacts when appropriate.
      */
-    @Parameter(defaultValue = "false", property = "useReleaseProfile")
     @Deprecated
+    @Parameter(defaultValue = "false", property = "useReleaseProfile")
     private boolean useReleaseProfile;
 
     /**
diff --git a/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PrepareReleaseMojo.java b/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PrepareReleaseMojo.java
index 4993d69d..3932b0ba 100644
--- a/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PrepareReleaseMojo.java
+++ b/maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PrepareReleaseMojo.java
@@ -62,7 +62,10 @@ public class PrepareReleaseMojo extends AbstractScmReadWriteReleaseMojo {
     private boolean resume;
 
     /**
-     * @deprecated Please use release:prepare-with-pom instead.
+     * Controls whether the plugin should generate release POMs during the
+     * prepare phase.
+     *
+     * @deprecated Use the {@code release:prepare-with-pom} goal instead.
      */
     @Deprecated
     @Parameter(defaultValue = "false", property = "generateReleasePoms")