add other top-level directories in specprod

Author: weaverba137

doc/DESI_SPECTRO_REDUX/SPECPROD/index.rst

@@ -6,23 +6,32 @@ Default $DESI_ROOT/spectro/redux/SPECPROD
 
 DESI spectroscopic data processing productions are grouped by spectroscopic
 production names (SPECPROD), named after mountains for data releases,
-e.g. "fuji" for the `Early Data Release <https://data.desi.lbl.gov/doc/releases/edr>`_.
+*e.g.* "iron" for `Data Release 1 <https://data.desi.lbl.gov/doc/releases/dr1>`_.
 
 Files in the top-level production directory:
 
-  * :doc:`exposures-SPECPROD.fits <exposures-SPECPROD>`: summary of exposures
-  * :doc:`tiles-SPECPROD.fits <tiles-SPECPROD>`: summary of tiles
-  
+* :doc:`exposures-SPECPROD.fits <exposures-SPECPROD>`: summary of exposures
+* :doc:`tiles-SPECPROD.fits <tiles-SPECPROD>`: summary of tiles
+
 Subdirectories under a spectroscopic production:
 
-  * :doc:`zcatalog/ <zcatalog/index>`: summary redshift catalogs
-  * :doc:`healpix/SURVEY/PROGRAM/PIXGROUP/PIXNUM <healpix/SURVEY/PROGRAM/PIXGROUP/PIXNUM/index>`:
-    spectra, classifications, and redshifts coadded across tiles, grouped by survey, program, and healpixel.
-  * :doc:`tiles/GROUPTYPE/TILEID/GROUPID/index <tiles/GROUPTYPE/TILEID/GROUPID/index>`:
-    spectra, classifications, and redshifts coadded per tile.
-  * :doc:`calibnight/NIGHT/ <calibnight/NIGHT/index>`: nightly calibrations
-  * :doc:`preproc/NIGHT/EXPID <preproc/NIGHT/EXPID/index>`: preprocessed spectrograph CCD images
-  * :doc:`exposures/NIGHT/EXPID <exposures/NIGHT/EXPID/index>`: per-exposure intermediate files
+* :doc:`zcatalog/ <zcatalog/index>`: summary redshift catalogs
+* :doc:`healpix/SURVEY/PROGRAM/PIXGROUP/PIXNUM <healpix/SURVEY/PROGRAM/PIXGROUP/PIXNUM/index>`:
+  spectra, classifications, and redshifts coadded across tiles, grouped by survey, program, and healpixel.
+* :doc:`tiles/GROUPTYPE/TILEID/GROUPID/index <tiles/GROUPTYPE/TILEID/GROUPID/index>`:
+  spectra, classifications, and redshifts coadded per tile.
+* :doc:`calibnight/NIGHT/ <calibnight/NIGHT/index>`: nightly calibrations
+* :doc:`preproc/NIGHT/EXPID <preproc/NIGHT/EXPID/index>`: preprocessed spectrograph CCD images
+* :doc:`exposures/NIGHT/EXPID <exposures/NIGHT/EXPID/index>`: per-exposure intermediate files
+
+Other subdirectories that represent internal desispec_ pipeline details, but do not contain production data:
+
+* exposure_tables/ : Details on individual exposures that are inputs to the pipeline.
+  For example, bad exposures may be marked in these tables.
+* processing_tables/ : Details on the processing status of individual exposures.
+* run/ : Scripts and log files produced by the desispec_ pipeline.
+
+.. _desispec: https://github.com/desihub/desispec
 
 .. toctree::
    :maxdepth: 1