From e7d304fbc6f0aa22b6105e2b1a4807c7a294eafa Mon Sep 17 00:00:00 2001
From: Wenzel Jakob <wenzel.jakob@epfl.ch>
Date: Fri, 17 Nov 2017 18:44:20 +0100
Subject: [PATCH] added citation reference (fixes #767) (#1189)

---
 docs/faq.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index d44a272bb..bfe830366 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -241,3 +241,19 @@ Common gotchas to watch out for involve not ``free()``-ing memory region
 that that were ``malloc()``-ed in another shared library, using data
 structures with incompatible ABIs, and so on. pybind11 is very careful not
 to make these types of mistakes.
+
+How to cite this project?
+=========================
+
+We suggest the following BibTeX template to cite pybind11 in scientific
+discourse:
+
+.. code-block:: bash
+
+    @misc{pybind11,
+       author = {Wenzel Jakob and Jason Rhinelander and Dean Moldovan},
+       year = {2017},
+       note = {https://github.com/pybind/pybind11},
+       title = {pybind11 -- Seamless operability between C++11 and Python}
+    }
+