The-turing-way: Edit references consistently

[pherterich]

Summary

References are currently inconsistent - going forward it might be nice to agree to one style.

What needs to be done?

Pick a referencing style - please vote below

• :rocket: for APA e.g. Several studies (Miller, 1999; Shafranske & Mahoney, 1998) and Buckhoff, T. A., & Colson, R. H. (2003). Preventing fraud by conducting background checks. CPA Journal, 73(11), 52
• :+1: for Chicago "After that I lived like a young rajah in all the capitals of Europe…" (Fitzgerald, 2004). and Fitzgerald, F. (2004). The great Gatsby. New York: Scribner.

Any others that people like?

Who can help?

Everyone to stop this being a librarian fight!

---

Updates

Lorem ipsum dolor sit amet, consectetur adipiscing.

[jezcope]

Looks like Jupyter-book supports automatic formatting of references, which would make this much easier: the ref style would be a single configuration setting somewhere and it would be consistent across the whole project.

Downside is that it would be a little less obvious how to cite for new contributors so I'm not going to advocate for it unequivocally.

The general process would be:

1. A single bibliographic database in the book repository in BibTeX format
2. Tags in the text that will get turned into a citation when the book is built. For example, this text: {% cite holdgraf_evidence_2014 %} generates this citation: (Holdgraf, de Heer, Pasley, & Knight, 2014).
3. Netlify configured to use the jekyll-scholar plugin

Thoughts?

[pherterich]

@masonlr and @cassgvp will attempt this as a proof of concept for a chapter

[masonlr]

We are looking at a central Zotero group to store all book references.

[rosiehigman]

Here is the existing Zotero group, it just needs a LOT of updating: https://www.zotero.org/groups/2252438/the_turing_way

[masonlr]

We're planning to add bibtex referencing to the Research Data Management chapter as a test. If this works well, we'll roll it out to all chapters.

[masonlr]

Thinking that just editing the .bib file checked in to this github repo will reduce a lot of the complexity. You can then use whatever local bibtex application you want, edit the bibtex directly, etc.

[cassgvp]

Successfully completed the proof of concept yesterday (@masonlr smashed out the process, I found references!) and it was looking sweet on a local (docker) build of the book! Next steps are to: 1) write up the procedure for authors in CONTRIBUTING.md; 2) scour through the existing content and fix the current references (maybe a separate issue for new contributors).

[masonlr]

@cassgvp we can pick this up on PR https://github.com/alan-turing-institute/the-turing-way/pull/623

[masonlr]

The references show up okay on the netlify preview, so this method should 'just work'.

[pherterich]

OMG, you are superstars :sparkles: - this is amazing!