update comments

Author: bhazelton

src/pyuvdata/uvbase.py

@@ -780,6 +780,8 @@ def _get_param_axis(self, axis_name: str, single_named_axis: bool = False):
             # find the axis number(s) with the named shape.
 
             attr = getattr(self, param)
+            # Only look at where form is a tuple, since that's the only case we
+            # can have a dynamically defined shape.
             if (
                 attr.value is not None
                 and isinstance(attr.form, tuple)
@@ -791,9 +793,7 @@ def _get_param_axis(self, axis_name: str, single_named_axis: bool = False):
                 ):
                     continue
 
-                # Only look at where form is a tuple, since that's the only case we
-                # can have a dynamically defined shape. Handle a repeated
-                # param_name in the form.
+                # Handle a repeated param_name in the form.
                 ret_dict[attr.name] = np.nonzero(np.asarray(attr.form) == axis_name)[0]
         return ret_dict
 

src/pyuvdata/uvdata/uvdata.py

@@ -5727,8 +5727,9 @@ def __add__(
                         info["key_arrays"]["other"][info["other_inds_use"]],
                     )
                 )
+                # Figure out order -- how to sort each axis.
                 if axis == "Npols":
-                    # order has info about how to sort each axis.
+                    # weird handling for pol integers
                     info["order"] = np.argsort(np.abs(info["combined_key_arrays"]))
                 elif axis == "Nfreqs" and (
                     np.any(np.diff(this.freq_array) < 0)