Merge pull request #4 from lsst/u/ebellm/initial_draft

Restructure prompt products docs

Author: MelissaGraham

docs/brokers/index.rst docs/access/brokers.rstdocs/brokers/index.rst renamed to docs/access/brokers.rst

@@ -0,0 +1,30 @@
+#####################
+Data Access & Brokers
+#####################
+
+Accessing prompt data products.
+
+Community Alert Brokers
+=======================
+
+Services that receive alerts in realtime.
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    brokers
+
+
+Alert Archive
+=============
+
+Image Access
+============
+
+Catalog Access
+==============
+
+Solar System Data Products
+==========================
+

docs/access/index.rst

@@ -25,6 +25,8 @@ When asked to cite the Prompt Products dataset as a whole please use:
 If you only use a specific subset, such as only the alerts, or a specific catalog table or image type, you may cite the DOI explicitly assigned to that subset.
 Each individual page in :doc:`/products/index` includes the relevant DOI.
 
+`citations.lsst.io <http://citations.lsst.io/>`_ provides a single point of reference for Rubin citations.
+
 
 How to refer to single objects
 ==============================

docs/cite.rst

@@ -4,75 +4,76 @@
 Vera C. Rubin Observatory Prompt Products
 #########################################
 
-**Anticipated start of Alert Production**: July 2025
+**Anticipated start of Alert Production**: February 2026
 
 .. important::
 
    This website is currently under development.
 
-Overview
-========
+Observations and Status
+=======================
 
-General information about the observations and data products.
+Information and live status for the Rubin observations producing alerts.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    :titlesonly:
 
-   Overview <overview/index>
-
+   Observations <observations/index>
 
-Brokers
-=======
+Data processing
+===============
 
-Software to process and serve alerts to scientists.
+Summary of the data processing steps that generate the data products.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    :titlesonly:
 
-   Brokers <brokers/index>
+   Data Processing <processing/index>
+
 
 Data products
 =============
 
-Descriptions and schema for the alert packets, catalogs, and images.
+Descriptions and schemas for the alert packets, catalogs, and images.
 
 .. toctree::
    :maxdepth: 2
    :titlesonly:
 
-   Data products <products/index>
+   Data Products <products/index>
 
-Data processing
-===============
+Data Access and Brokers
+=======================
 
-Summaries of the data processing steps that generate the data products.
+How to access Prompt Products through community alert brokers and the Rubin Science Platform.
 
 .. toctree::
    :maxdepth: 2
    :titlesonly:
 
-   Processing <processing/index>
+   Data Access <access/index>
+
 
-Data access and analysis
-========================
+Tutorials
+=========
 
-Tutorials demonstrating how to access and analyze data via the Rubin Science Platform (RSP).
+Tutorials demonstrating how to access and analyze data.
 
 .. toctree::
    :maxdepth: 2
    :titlesonly:
 
    Tutorials <tutorials/index>
 
-How to cite
-===========
+Citing Prompt Products
+======================
 
 How to cite Rubin Observatory and the Prompt data products.
 
 .. toctree::
     :maxdepth: 1
-    :glob:
+    :titlesonly:
 
-    cite
+    Citing Prompt Products <cite>

docs/index.rst

@@ -0,0 +1,29 @@
+#######################
+Observations and Status
+#######################
+
+.. important::
+
+   **Placeholder.** Rubin Observatory is still in an early operations optimization phase.
+
+The key objective is to improve the image quality and survey efficiency in order to start the ten-year LSST survey.
+The amount of science-grade data collected during this phase will vary.
+
+
+
+Survey strategy
+===============
+
+Information about the strategy and cadence for the Legacy Survey of Space and Time can be found at `survey-strategy.lsst.io <https://survey-strategy.lsst.io/>`_.
+
+Nightly projection
+------------------
+
+The projected Rubin schedule can be obtained via ObsLocTAP `programatically <https://usdf-rsp.slac.stanford.edu/obsloctap/schedule?time=24>`_ or with a `viewer <https://usdf-rsp.slac.stanford.edu/obsloctap/static/viewer.html>`_.
+A `tutorial <https://github.com/lsst/tutorial-notebooks/blob/main/Commissioning/102_rubin_schedule_viewer.ipynb>`_ is available.
+
+
+Alert stream status
+===================
+
+A live dashboard showing alert processing over the last twelve hours is available at `ls.st/alert-stream-status <https://ls.st/alert-stream-status>`_.

docs/observations/index.rst

@@ -4,14 +4,14 @@
 Template generation
 ###################
 
-.. important::
+Template coadded images are created by combining multiple calibrated images obtained in the same filter and of the same region of the sky.
+This coaddition reduces noise, gaps, and artifacts.
 
-   **Placeholder.** Prompt data processing is under construction.
+Incremental Template Generation
+===============================
 
-
-Template coadded images are created by combining multiple calibrated images obtained in the
-same filter and of the same region of the sky to achieve a sharper image
-(i.e., by selecting images with good seeing).
+Template Availability
+=====================
 
 
 Coadds by patch