From 18fa168660b5a1913ed847fc774b7998165e2a9d Mon Sep 17 00:00:00 2001
From: Rita Weng <rita.weng@samtec.com>
Date: Thu, 5 Oct 2023 16:16:32 +0800
Subject: [PATCH] Add Citing Section

---
 doc/about/citing.rst  | 41 +++++++++++++++++++++++++++++++++++++++++
 doc/about/roadmap.rst |  1 +
 2 files changed, 42 insertions(+)
 create mode 100644 doc/about/citing.rst

diff --git a/doc/about/citing.rst b/doc/about/citing.rst
new file mode 100644
index 000000000..2e1e2fd7a
--- /dev/null
+++ b/doc/about/citing.rst
@@ -0,0 +1,41 @@
+Citing
+===============
+
+Vega-Altair
+-----------
+If you use Vega-Altair in academic work, please consider citing
+`Altair: Interactive Statistical Visualizations for Python <https://joss.theoj.org/papers/10.21105/joss.01057>`_ as
+
+.. code-block::
+
+  @article{VanderPlas2018,
+    doi = {10.21105/joss.01057},
+    url = {https://doi.org/10.21105/joss.01057},
+    year = {2018},
+    publisher = {The Open Journal},
+    volume = {3},
+    number = {32},
+    pages = {1057},
+    author = {Jacob VanderPlas and Brian Granger and Jeffrey Heer and Dominik Moritz and Kanit Wongsuphasawat and Arvind Satyanarayan and Eitan Lees and Ilia Timofeev and Ben Welsh and Scott Sievert},
+    title = {Altair: Interactive Statistical Visualizations for Python},
+    journal = {Journal of Open Source Software}
+  }
+
+Vega-Lite
+---------
+Please additionally consider citing the
+`Vega-Lite <https://vega.github.io/vega-lite/>`_ project, which Vega-Altair is based on:
+`Vega-Lite: A Grammar of Interactive Graphics <https://dl.acm.org/doi/10.1109/TVCG.2016.2599030>`_
+
+.. code-block::
+
+  @article{Satyanarayan2017,
+    author={Satyanarayan, Arvind and Moritz, Dominik and Wongsuphasawat, Kanit and Heer, Jeffrey},
+    title={Vega-Lite: A Grammar of Interactive Graphics},
+    journal={IEEE transactions on visualization and computer graphics},
+    year={2017},
+    volume={23},
+    number={1},
+    pages={341-350},
+    publisher={IEEE}
+  }
\ No newline at end of file
diff --git a/doc/about/roadmap.rst b/doc/about/roadmap.rst
index 07f8fe576..9dd20ca34 100644
--- a/doc/about/roadmap.rst
+++ b/doc/about/roadmap.rst
@@ -162,3 +162,4 @@ Areas of focus:
    self
    code_of_conduct
    governance
+   citing