Citation?

[ianhbell]

I've looked throughout the docs, but can't find a preferred citation for pybind11. I'm writing several publications presently that make heavy use of pybind11 as a shim layer between various C++ libraries that I have written and python. Do you have a canonical reference for pybind11?

[wjakob]

Given the current set of maintainers, I propose the following:

@misc{pybind11,
   author = {Wenzel Jakob and Jason Rhinelander and Dean Moldovan},
   year = {2016},
   note = {https://github.com/pybind/pybind11},
   title = {pybind11 — Seamless operability between C++11 and Python}
} 

Is that fine with everyone?

[wjakob]

If somebody has a better idea on how to cite software via bibtex, I'm all ears :)

[jagerman]

2016 -> 2017, but otherwise good with me.

[jagerman]

According to this BibLaTeX supports a @software with a version, but it's otherwise essentially just a @misc alias.

[ianhbell]

Only change I might recommend is to use a -- instead of a —. At least for me I use ASCII bibtex (only).

Somewhat related: is there a list of projects using pybind11? I have a lot of projects using pybind11 now, and some are really simple demonstrations that might be appropriate to those just getting started.

[loriab]

Thanks for the citation guidance. Since that sort of citation is hard to track and academic funding agencies like publications, here's a doi.

[wjakob]

Fixed in e7d304f

[sbrodehl]

Hi @wjakob and others,

is the citation in the docs still "valid"?
One can also add a CITATION file, because the first thing I found was this issue, then, looking at the commit, the place in the docs, and after this I confirmed the citation in the docs.

Thanks!

[andrewfowlie]

I was also wondering if the bibtex was out of date. FWIW, I think I will use this bibtex

@misc{pybind11,
   author = "{W. Jakob, J. Rhinelander, D. Moldovan and \href{https://github.com/pybind/pybind11/graphs/contributors}{others}}",
   year = {2017},
   title = "{\href{https://github.com/pybind/pybind11}{pybind11 -- Seamless operability between C++11 and Python}}"
}