DOC: Complete API for lastframe (#10415)

Author: pllim

docs/jwst/lastframe/api_ref.rst

@@ -0,0 +1,15 @@
+===
+API
+===
+
+Public Step API
+===============
+
+.. automodapi:: jwst.lastframe.lastframe_step
+   :no-inheritance-diagram:
+
+Complete Developer API
+======================
+
+.. automodapi:: jwst.lastframe.lastframe_sub
+   :no-inheritance-diagram:

docs/jwst/lastframe/arguments.rst

@@ -1,7 +1,7 @@
 Description
 ===========
 
-:Class: `jwst.lastframe.LastFrameStep`
+:Class: `jwst.lastframe.lastframe_step.LastFrameStep`
 :Alias: lastframe
 
 The last frame correction step is only applied to MIRI data and flags the
@@ -15,6 +15,10 @@ groups to work with in later steps.
 
 Only the GROUPDQ array is modified. The SCI, ERR, and PIXELDQ arrays are unchanged.
 
+Step Arguments
+--------------
+The ``lastframe`` step does not have any step-specific arguments.
+
 Reference Files
 ---------------
 The ``lastframe`` step does not use any reference files.

docs/jwst/lastframe/description.rst

@@ -8,6 +8,4 @@ Last Frame Correction
    :maxdepth: 2
 
    description.rst
-   arguments.rst
-
-.. automodapi:: jwst.lastframe
+   api_ref.rst

docs/jwst/lastframe/index.rst

@@ -1,3 +1,5 @@
+"""Set data quality flag of last group in MIRI data."""
+
 import logging
 
 from stdatamodels.jwst import datamodels
@@ -14,7 +16,7 @@ class LastFrameStep(Step):
     """
     Set data quality flags for the last group in MIRI ramps.
 
-    If the number of groups > 2, the GROUP
+    If the number of groups is greater than 2, the GROUP
     data quality flag for the final group will be set to DO_NOT_USE.
     """
 
@@ -25,7 +27,7 @@ class LastFrameStep(Step):
 
     def process(self, step_input):
         """
-        For MIRI data with more than 2 groups, set final group dq to DO_NOT_USE.
+        For MIRI data with more than 2 groups, set final group DQ to DO_NOT_USE.
 
         Parameters
         ----------

jwst/lastframe/lastframe_step.py

@@ -1,6 +1,5 @@
-#
-#  Module for the lastframe correction for MIRI science data sets
-#
+"""Utility functions for the lastframe correction for MIRI science data sets."""
+
 import logging
 
 from stdatamodels.jwst.datamodels import dqflags
@@ -20,12 +19,12 @@ def do_correction(output):
 
     Parameters
     ----------
-    output : DataModel
+    output : `~stdatamodels.jwst.datamodels.JwstDataModel`
         Science data to be corrected
 
     Returns
     -------
-    output : DataModel
+    output : `~stdatamodels.jwst.datamodels.JwstDataModel`
         Lastframe-corrected science data
     """
     # Save some data params for easy use later