Add Swift/BAT-GUANO data listings

CHANGELOG.md

@@ -10,7 +10,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ## \[Unreleased\]
 
-(none)
+## Added
+
+- Data listings and references for Swift/BAT-GUANO
 
 ## \[v0.3.15\] - 2025-05-12
 

docs/source/listings.rst

@@ -220,3 +220,45 @@ Cloud Storage Buckets
         including image cutouts and metadata. Each alert is stored as a separate Avro file.
         The filename syntax is: `<schema_version>/<alert_date>/<diaObjectId>/<diaSourceId>.avro`.
         For example, `v7_3/2026-10-01/3516505565058564097/3527242976319242284.avro`.
+
+.. _data swift:
+
+Swift/BAT-GUANO
+-------------------------------
+
+:ref:`Neil Gehrels Swift Observatory <survey swift>` is a space-based observatory designed to study gamma-ray bursts and currently produces an alert stream at a rate of less than 1 alert per week.
+
+Pub/Sub Alert Streams
+^^^^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+    :class: tight-table
+    :widths: 25 75
+    :header-rows: 1
+
+    * - Topic
+      - Description
+
+    * - .. centered:: *Data Streams*
+      -
+
+    * - swift-alerts
+      - Swift alert stream in Pub/Sub.
+        Messages contain the original alert bytes and metadata.
+
+BigQuery Tables
+^^^^^^^^^^^^^^^
+
+.. list-table::
+    :class: tight-table
+    :widths: 15 15 70
+    :header-rows: 1
+
+    * - Dataset
+      - Table
+      - Description
+
+    * - swift_alerts
+      - alerts_v4_5_0
+      - Alert data for Swift/BAT-GUANO schema version 4.5.0. This table is an archive of the swift-alerts Pub/Sub stream.
+        It has the same schema as the original alert bytes.

docs/source/surveys/index.rst

@@ -11,3 +11,4 @@ Note that data products may be served in multiple formats -- a complete listing
     ztf
     lvk
     lsst
+    swift

docs/source/surveys/swift.rst

@@ -0,0 +1,16 @@
+.. _survey swift:
+
+Swift
+======================
+
+Swift is a MidEx class mission operated by NASA in partnership with agencies in Italy and the United Kingdom.
+It produces an alert stream of gamma ray transients at a rate of less than 1 alert per week.
+
+Collaboration resources:
+
+- `Swift Homepage <https://swift.gsfc.nasa.gov>`__
+- `Swift's Burst Array Telescope (BAT) Homepage <https://swift.gsfc.nasa.gov/about_swift/bat_desc.html>`__
+
+Data products:
+
+- Alert Stream. Complete documentation can be found at `<https://gcn.nasa.gov/missions/swift#json-serialized-gcn-notice-types-in-gcn-kafka>`__.