citing em geosci

[lheagy]

We should include a description for how people should cite EM geosci. I suggest we do something similar to astropy which starts the citation with "Astropy collaboration" and then lists all contributors. Listing contributors is a bit of a question, but on option is to list all who have contributed on github as authors. Note that we should first get permission from everyone. If we treat it like a book, then we can also reference editors if that makes sense? The doi is then the doi from zenodo.

Thoughts?

[thast]

Some thoughts: Scikit-Learn chose to also include quite a number of contributors as Authors:
@Article{scikit-learn,
title={Scikit-learn: Machine Learning in {P}ython},
author={Pedregosa, F. and Varoquaux, G. and Gramfort, A. and Michel, V.
and Thirion, B. and Grisel, O. and Blondel, M. and Prettenhofer, P.
and Weiss, R. and Dubourg, V. and Vanderplas, J. and Passos, A. and
Cournapeau, D. and Brucher, M. and Perrot, M. and Duchesnay, E.},
journal={Journal of Machine Learning Research},
volume={12},
pages={2825--2830},
year={2011}
}

[thast]

So here is a proposal. As for author, after the main leaders for the DISC (Doug, Lindsey and Seogi), I have listed every person that have commit to the website, by order of quantitative contribution. For the year, I chose the year of first online publication (2015):

@misc{EMGeoSci, author = {Douglas W. Oldenburg and Lindsey J. Heagy and Seogi Kang and Devin C. Cowan and Dominique Fournier and Thibaut Astic and Sarah Devriese and Dikun Yang and Sanna Tyrväinen and Ronghua Peng and Patrick Belliveau and Luz Ang{\'e}lica Caudillo-Mata and Daniel Bild-Enkin and Mike McMillan and Gu{\~d}ni Karl Rosenkj{\ae}r and Rowan Cockett and Michael Mitchell}, title = {E{M} {G}eo{S}ci: A online textbook for electromagnetic geophysics}, url = {https://em.geosci.xyz}, howpublished = {\url{https://em.geosci.xyz}}, urldate = {2019-02-01}, doi = {10.5281/zenodo.2548027}, year = {2015}, note = {Accessed: 2019-02-01}, }

Output:
Oldenburg, D. W., Heagy, L. J., Kang, S., Cowan, D. C., Fournier, D., Astic, T., Devriese, S., Yang, D., Tyrväinen, S., Peng, R., Belliveau, P., Caudillo-Mata, L. A., Bild-Enkin, D., McMillan, M., Rosenkjær, G. K., Cockett, R., & Mitchell, M., 2015. EM GeoSci: A online textbook for electromagnetic geophysics, https://em.geosci.xyz, Accessed: 2019-02-01

Optionally there is the decorator @online but it did not worked well for me.

[lheagy]

Thanks @thast this looks good. The only other thing I would suggest we consider is that the first author be "GeoSci.xyz Project".

e.g.

@misc{EMGeoSci,
 author = {{GeoSci.xyz Project} and Douglas W. Oldenburg and Lindsey J. Heagy and
 Seogi Kang and Devin C. Cowan and Dominique Fournier and
 Thibaut Astic and Sarah Devriese and Dikun Yang and
 Sanna Tyrväinen and Ronghua Peng and Patrick Belliveau and
 Luz Ang{\'e}lica Caudillo-Mata and Daniel Bild-Enkin and Mike McMillan
 and Gu{\~d}ni Karl Rosenkj{\ae}r and Rowan Cockett and Michael Mitchell},
 title = {E{M} {G}eo{S}ci: A online textbook for electromagnetic geophysics},
 url = {https://em.geosci.xyz},
 howpublished = {\url{https://em.geosci.xyz}},
 urldate = {2019-02-01},
 doi = {10.5281/zenodo.2548027},
 year = {2015},
 note = {Accessed: 2019-02-01},
}

Both Astropy and Jupyter do this - then in citations it is (GeoSci.xyz Project et al., 2015). I like this as it leaves room for future contributors to be acknowledged as a part of the project, as well as people who may not have directly contributed on GitHub but helped with text etc.

What do you think about this? cc @dougoldenburg

[santisoler]

Revisiting this after talking today with @MasayukiMotoori about geosci lacking a section on How to Cite it.

Would be nice to add a CITATION.cff along with a section in the landing page (or as another section in the website) on how to cite it.