Document deprecation of ModelETL#getModel() (#1447)

Clarified that getModel() is a temporary legacy accessor and will be
removed once transform() is fully implemented. Added guidance to rely
on the extract -> transform -> load pipeline instead.

Author: anukalp2804

maven-release-manager/src/main/java/org/apache/maven/shared/release/transform/ModelETL.java

@@ -51,11 +51,17 @@ 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();

maven-release-plugin/src/main/java/org/apache/maven/plugins/release/PerformReleaseMojo.java

@@ -90,7 +90,6 @@ public class PerformReleaseMojo extends AbstractScmReadReleaseMojo {
      * 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
      */
     @Parameter(defaultValue = "false", property = "useReleaseProfile")