Skip to content
Host repository for The Turing Way: a how to guide for reproducible data science
CSS HTML JavaScript Ruby TeX Python Other
Branch: master
Clone or download
Latest commit 8c0ed14 Nov 8, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Remove additional line breaks May 22, 2019
book Merge pull request #725 from erictleung/emphasize-key-phrases Nov 7, 2019
communications Update newsletter_07_Oct2019.md Oct 8, 2019
conferences added links to OSFair2019 presentations Sep 18, 2019
project_management Add youtube links Oct 3, 2019
scripts minor formatting May 28, 2019
templates Updating Github templates May 17, 2019
workshops Minor typo Sep 19, 2019
.all-contributorsrc docs: update .all-contributorsrc Nov 6, 2019
.gitignore
.pre-commit-config.yaml Add prettier travis instructions, pre-commit Jun 5, 2019
.prettierignore Add prettier travis instructions, pre-commit Jun 5, 2019
.travis.yml test: Add --prose-wrap preserve option Jun 5, 2019
CODE_OF_CONDUCT.md her -> their Oct 16, 2019
CONTRIBUTING.md Fix contributing typo and remove trailing spaces Oct 17, 2019
GOVERNANCE.md Read through months later Oct 30, 2019
LICENSE.md Update LICENSE.md Oct 17, 2019
README.md Merge pull request #742 from alan-turing-institute/feature/matrix-org… Nov 7, 2019
book_skeleton.md Update book_skeleton.md Mar 4, 2019
contributors.md Add myself to contributors.md May 17, 2019
tips_and_tricks_survey.md Update tips_and_tricks_survey.md Feb 12, 2019
ways_of_working.md Adjust team contact section Nov 4, 2019

README.md

The Turing Way

Build Status All Contributors Read the book Join our tinyletter mailing list Join the chat at https://gitter.im/alan-turing-institute/the-turing-way DOI

The Turing Way is a lightly opinionated guide to reproducible data science.

Our goal is to provide all the information that researchers need at the start of their projects to ensure that they are easy to reproduce at the end.

This also means making sure PhD students, postdocs, PIs and funding teams know which parts of the "responsibility of reproducibility" they can affect, and what they should do to nudge data science to being more efficient, effective and understandable.

Table of contents:

🎧 If you prefer an audio introduction to the project, our team member Rachael presented at the Open Science Fair 2019 in Porto and her demo was recorded by the Orion podcast. The Turing Way overview starts at minute 5:13.

About the project

Reproducible research is necessary to ensure that scientific work can be trusted. Funders and publishers are beginning to require that publications include access to the underlying data and the analysis code. The goal is to ensure that all results can be independently verified and built upon in future work. This is sometimes easier said than done. Sharing these research outputs means understanding data management, library sciences, software development, and continuous integration techniques: skills that are not widely taught or expected of academic researchers and data scientists. As these activities are not commonly taught, we recognise that the burden of requirement and new skill acquisition can be intimidating to individuals who are new to this world. The Turing Way is a handbook to support students, their supervisors, funders and journal editors in ensuring that reproducible data science is "too easy not to do" even for people who have never worked in this way before. It will include training material on version control, analysis testing, and open and transparent communication with future users, and build on Turing Institute case studies and workshops. This project is openly developed and any and all questions, comments and recommendations are welcome at our github repository: https://github.com/alan-turing-institute/the-turing-way.

The team

This is the (part of) the project team planning work at the Turing Institute. For more on how to contact us, see the ways of working document.

Team photo

Contributing

🚧 This repository is always a work in progress and everyone is encouraged to help us build something that is useful to the many. 🚧

Everyone is asked to follow our code of conduct and to checkout our contributing guidelines for more information on how to get started.

If you are not familiar or confident contributing on GitHub, you can also contribute a case study and your tips and tricks via our Google submission form.

Citing The Turing Way

You can reference The Turing Way through the project's Zenodo archive using DOI: 10.5281/zenodo.3233853. DOIs allow us to archive the repository and they are really valuable to ensure that the work is tracked in academic publications.

The citation will look something like:

The Turing Way Community, Becky Arnold, Louise Bowler, Sarah Gibson, Patricia Herterich, Rosie Higman, … Kirstie Whitaker. (2019, March 25). The Turing Way: A Handbook for Reproducible Data Science (Version v0.0.4). Zenodo. http://doi.org/10.5281/zenodo.3233986

You can also share the human-readable URL to a page in the book, for example: https://the-turing-way.netlify.com/reproducibility/03/definitions.html, but be aware that the project is under development and therefore these links may change over time. You might want to include a web archive link such as: https://web.archive.org/web/20191030093753/https://the-turing-way.netlify.com/reproducibility/03/definitions.html to make sure that you don't end up with broken links everywhere!

We really appreciate any references that you make to The Turing Way project in your and we hope it is useful. If you have any questions please get in touch.

Get in touch

We have a gitter chat room and we'd love for you to swing by to say hello at https://gitter.im/alan-turing-institute/the-turing-way. That room is also synchronised with Matrix at #the-turing-way:matrix.org and you're welcome to join us there if you prefer.

We also have a tiny letter mailing list to which we send monthly project updates. Subscribe at https://tinyletter.com/TuringWay.

You can contact our community manager Malvika Sharan by email at msharan@turing.ac.uk. Alternatively, you can contact the lead investigator Kirstie Whitaker by email at kwhitaker@turing.ac.uk.

Contributors

Thanks goes to these wonderful people (emoji key):

Rachael Ainsworth
Rachael Ainsworth

📖 📋 🤔 💬 👀 📢
Tarek Allam
Tarek Allam

🚇 📖
Tania Allard
Tania Allard

🤔 💬
Becky Arnold
Becky Arnold

💬 💻 📖 🤔 👀
Louise Bowler
Louise Bowler

💬 💻 📖 💡 🤔 📋 👀
Stephan Druskat
Stephan Druskat

📖
Stephen Eglen
Stephen Eglen

👀
Oliver Forrest
Oliver Forrest

📖 🤔
Jason Gates
Jason Gates

📖 👀
Sarah Gibson
Sarah Gibson

💬 💻 📖 🔧 👀 📢 🤔
Richard Gilham
Richard Gilham

📖 🤔
Tim Head
Tim Head

💬 🤔
Patricia Herterich
Patricia Herterich

💬 📖 👀 🤔 🖋
Rosie Higman
Rosie Higman

💬 📋 👀 🤔
Ian Hinder
Ian Hinder

📖
Hieu Hoang
Hieu Hoang

🤔
Dan Hobley
Dan Hobley

📖
Chris Holdgraf
Chris Holdgraf

💬 🤔
Will Hulme
Will Hulme

📖
Anna Krystalli
Anna Krystalli

💬 💡 👀 🤔
Clare Liggins
Clare Liggins

📖
Robin Long
Robin Long

📖
Alexander Morley
Alexander Morley

💬 👀 🤔 ⚠️
Martin O'Reilly
Martin O'Reilly

💬 🔧 🤔
Rosti Readioff
Rosti Readioff

📖
James Robinson
James Robinson

🤔 💻
Ali Seyhun Saral
Ali Seyhun Saral

📖
Andrew Stewart
Andrew Stewart

Sarah Stewart
Sarah Stewart

📖
Oliver Strickson
Oliver Strickson

💬 📖
Gertjan van den Burg
Gertjan van den Burg

📖 🤔 💬
Kirstie Whitaker
Kirstie Whitaker

💬 📖 🎨 📋 🔍 🤔 👀 📢
Yo Yehudi
Yo Yehudi

📖 👀
jspickering
jspickering

📖
Alex Clarke
Alex Clarke

📖
Javier Moldon
Javier Moldon

📖
joe-fennell
joe-fennell

📖
Greg Kiar
Greg Kiar

📖 👀
Beth Montague-Hellen
Beth Montague-Hellen

📖
OliJimbo
OliJimbo

📖
Jez Cope
Jez Cope

📖
Chanuki Illushka Seresinhe
Chanuki Illushka Seresinhe

📖
Diego
Diego

🤔 👀
nadiasoliman
nadiasoliman

📖
NatalieThurlby
NatalieThurlby

💻 ⚠️
Michael J Grayling
Michael J Grayling

📖
Lachlan Mason
Lachlan Mason

🤔 📖 💻
Susanna-Assunta Sansone
Susanna-Assunta Sansone

📖
taunsquared
taunsquared

📖
Eric Daub
Eric Daub

📖
Camila Rangel Smith
Camila Rangel Smith

📖
Oscar T Giles
Oscar T Giles

📖
cassgvp
cassgvp

🤔 📖
Malvika Sharan
Malvika Sharan

📖
Kevin Kunzmann
Kevin Kunzmann

📖 🤔
Eirini Malliaraki
Eirini Malliaraki

📖
James Myatt
James Myatt

📖
James Kent
James Kent

🐛
Liberty Hamilton
Liberty Hamilton

🐛
RohitMidha23
RohitMidha23

📖
Elizabeth DuPre
Elizabeth DuPre

🚇 💬 👀
Paula Andrea Martinez
Paula Andrea Martinez

🤔
Chris Markiewicz
Chris Markiewicz

🤔
Eric Leung
Eric Leung

🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

You can’t perform that action at this time.