added published paper citation

- updated README
- add citation page to docs
- add preferred citation to CITATION.cff

Author: orbeckst

CITATION.cff

@@ -4,8 +4,8 @@
 cff-version: 1.2.0
 title: 'Zarrtraj: A Python package for streaming molecular dynamics trajectories from cloud services'
 message: >-
-  If you use this software, please cite it using the
-  metadata from this file.
+  If you use this software, please cite the JOSS paper listed
+  under preferred-citation.
 type: software
 authors:
   - given-names: Lawson
@@ -65,3 +65,35 @@ keywords:
   - mdanalysis
   - zarr
 license: MIT
+preferred-citation:
+  type: article
+  title: >-
+    Zarrtraj: A Python package for streaming molecular dynamics
+    trajectories from cloud services
+  authors:
+    - given-names: Lawson
+      family-names: Woods
+      orcid: 'https://orcid.org/0009-0003-0713-4167'
+    - given-names: Hugo
+      family-names: MacDermott-Opeskin
+      orcid: 'https://orcid.org/0000-0002-7393-7457'
+    - given-names: Edis
+      family-names: Jakupovic
+      orcid: 'https://orcid.org/0000-0001-8813-6356'
+    - given-names: Yuxuan
+      family-names: Zhuang
+      orcid: 'https://orcid.org/0000-0003-4390-8556'
+    - given-names: Richard
+      family-names: Gowers
+      name-particle: J
+      orcid: 'https://orcid.org/0000-0002-3241-1846'
+    - given-names: Oliver
+      family-names: Beckstein
+      orcid: 'https://orcid.org/0000-0003-1340-0831'
+  journal: Journal of Open Source Software
+  year: 2026
+  volume: 11
+  issue: 121
+  start: 7943
+  doi: 10.21105/joss.07943
+  url: 'https://doi.org/10.21105/joss.07943'

README.md

@@ -45,9 +45,28 @@ and is available under the MIT License (see the file [LICENSE](https://github.co
 
 Copyright (c) 2024, Lawson Woods
 
+### Citation
+
+If you use Zarrtraj in published work, please cite:
+
+> Lawson Woods, Hugo MacDermott-Opeskin, Edis Jakupovic, Yuxuan Zhuang, Richard J Gowers, and Oliver Beckstein. (2026). Zarrtraj: A Python package for streaming molecular dynamics trajectories from cloud services. Journal of Open Source Software, 11(121), 7943, https://doi.org/10.21105/joss.07943
+
+```bibtex
+@article{Woods2026zarrtraj,
+  author = {Woods, Lawson and MacDermott-Opeskin, Hugo and Jakupovic, Edis and Zhuang, Yuxuan and Gowers, Richard J and Beckstein, Oliver},
+  title = {Zarrtraj: A Python package for streaming molecular dynamics trajectories from cloud services},
+  journal = {Journal of Open Source Software},
+  year = {2026},
+  volume = {11},
+  number = {121},
+  pages = {7943},
+  doi = {10.21105/joss.07943},
+  url = {https://doi.org/10.21105/joss.07943}
+}
+```
 
 #### Acknowledgements
 
 Project based on the 
 [MDAnalysis Cookiecutter](https://github.com/MDAnalysis/cookiecutter-mda) version 0.1.
-Please cite [MDAnalysis](https://github.com/MDAnalysis/mdanalysis#citation) when using Zarrtraj in published work.
+Please also cite [MDAnalysis](https://www.mdanalysis.org/citations/#mdanalysis-library) when using Zarrtraj in published work.

docs/source/citation.rst

@@ -0,0 +1,32 @@
+Citation
+========
+
+If you use Zarrtraj in published work, please cite our JOSS paper:
+
+.. code-block:: none
+
+   Lawson Woods, Hugo MacDermott-Opeskin, Edis Jakupovic, Yuxuan Zhuang, Richard J Gowers, and Oliver Beckstein. (2026). Zarrtraj: A Python package for streaming molecular dynamics trajectories from cloud services. Journal of Open Source Software, 11(121), 7943, https://doi.org/10.21105/joss.07943
+
+BibTeX
+------
+
+.. code-block:: bibtex
+
+   @article{Woods2026zarrtraj,
+     author = {Woods, Lawson and MacDermott-Opeskin, Hugo and Jakupovic, Edis and Zhuang, Yuxuan and Gowers, Richard J and Beckstein, Oliver},
+     title = {Zarrtraj: A Python package for streaming molecular dynamics trajectories from cloud services},
+     journal = {Journal of Open Source Software},
+     year = {2026},
+     volume = {11},
+     number = {121},
+     pages = {7943},
+     doi = {10.21105/joss.07943},
+     url = {https://doi.org/10.21105/joss.07943}
+   }
+
+Acknowledgements
+----------------
+
+Zarrtraj is an `MDAnalysis MDAKit <https://mdakits.mdanalysis.org>`__.
+Please also cite `MDAnalysis <https://www.mdanalysis.org/citations/#mdanalysis-library>`__
+when using Zarrtraj in published work.

docs/source/index.rst

@@ -22,4 +22,5 @@ This means users can interact with massive trajectory files without ever storing
    performance_considerations
    zarrmd-file-spec/v0.2.0
    benchmarks
+   citation