Refactor ePSF building

CHANGES.rst

@@ -41,6 +41,12 @@ New Features
   - Added ``__repr__`` methods to ``ImagePSF`` and ``GriddedPSFModel``.
     [#2134]
 
+  - Added a ``shape`` property to ``ImagePSF``. [#2158]
+
+  - ``EPSFBuilder`` now automatically excludes stars that repeatedly
+    fail fitting and emits warnings with specific failure reasons.
+    [#2158]
+
 Bug Fixes
 ^^^^^^^^^
 
@@ -89,6 +95,21 @@ API Changes
 
   - Removed the ``ModelGridPlotMixin`` class. [#2137]
 
+  - Removed the ``norm_radius`` keyword from ``EPSFBuilder``. [#2158]
+
+  - Removed the ``build_epsf`` method from ``EPSFBuilder``. Use the
+    callable interface (``builder(stars)``) instead. [#2158]
+
+  - Removed the deprecated ``FittableImageModel`` and ``EPSFModel``
+    classes. Use ``ImagePSF`` instead. [#2158]
+
+  - ``EPSFBuilder`` now returns an ``EPSFBuildResult`` dataclass
+    containing the ePSF, fitted stars, iteration count, convergence
+    status, and excluded star diagnostics. Tuple unpacking is still
+    supported for backward compatibility. [#2158]
+
+  - ``LinkedEPSFStar`` no longer inherits from ``EPSFStars``. [#2158]
+
 
 2.3.0 (2025-09-15)
 ------------------

docs/conf.py

@@ -74,8 +74,13 @@
 
 extensions += [
     'sphinx_design',
+    'sphinx_reredirects',
 ]
 
+redirects = {
+    'user_guide/epsf': 'epsf_building.html',
+}
+
 # This is added to the end of RST files - a good place to put
 # substitutions to be used globally.
 rst_epilog = """