Awesome Open Source
Awesome Open Source

The Turing Way

This file in also available in Dutch (README-Dutch), French (, German (, Indonesian (README-Indonesian), Italian (README-Italian), Korean (README-Korean), Portuguese (README-Portuguese), and Spanish (README-Spanish) (listed alphabetically).

Total Contributors:

All Contributors

Information Links
Project Read the book
News Twitter Follow Join our tinyletter mailing list YouTube Channel Views
Chat Join Slack GitHub issues GitHub pull requests
Build Netlify build Latin Phrases TestFileSizes Check for Lorem Ipsums
Cite Cite this using DOI

Welcome to The Turing Way project GitHub repository. This is where all the components of the project are developed, reviewed and maintained.

The Turing Way is a handbook to reproducible, ethical and collaborative data science. We involve and support a diverse community of contributors to make data science accessible, comprehensible and effective for everyone. Our goal is to provide all the information that researchers and data scientists in academia, industry and the public sector need at the start of their projects to ensure that they are easy to reproduce at the end.

The Turing Way project is a book, community, an open-source project and a culture of collaboration. This is shown in four illustrations, the first one showing the Turing Way book, the second showing how the community can grow, the third one showing two people collaborating on a pull request, the last one is showing a balance where reproducibility is valued more than the number of papers published.

The Turing Way is a book, a community and a global collaboration.

All stakeholders, including students, researchers, software engineers, project leaders and funding teams, are encouraged to use The Turing Way to understand their roles and responsibility of reproducibility in data science. You can read the book online, contribute to the project as described in our contribution guidelines and re-use all materials (see the License).

This is a screenshot of the online Turing Way book. It also shows one of the Turing Way illustrations at the beginning of the book. In this illustration, there is a road or path with shops for different data science skills. People can go in and out with their shopping cart and pick and choose what they need.

Screenshot of The Turing Way online book (use this image in a presentation)

Started in 2019 as a lightly opinionated guide to data science, The Turing Way has since expanded into a series of guides on Reproducible Research, Project Design, Communication, Collaboration and Ethical Research. Each guide offers chapters on a range of topics covering best practices, guidance and recommendations. These chapters have been co-authored by contributors who are students, researchers, educators, community leaders, policy-makers and professionals from diverse backgrounds, lived experiences and domain knowledge.

Our moonshot goal is to make reproducibility "too easy not to do".

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:

The Team

The Turing Way is an open collaboration and community-driven project. Everyone who contributes to this book, no matter how small or big their contributions are, is recognised in this project as a contributor and a community member. Long-term contributors of the project are considered part of the core contributors groups who take on various leadership roles in the project.

The project is coordinated by the co-lead investigators Kirstie Whitaker (founder) and Malvika Sharan, and hosted at The Alan Turing Institute. Anne Lee Steele is the Community Manager of The Turing Way since March 2022.

You can read The Turing Way acknowledgement process and Record of Contributions to learn about how we acknowledge your work and how our contributors are highlighted in the project. Please see the Contributors Table for the GitHub profiles of all our contributors.


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

Everyone who joins the project is expected to follow our code of conduct and to check out our contributing guidelines for more information on how to get started. We want to meet our contributors where they are. Therefore, we provide multiple entry points for you to contribute based on your interest, availability or skill requirements.

This image shows six of many kinds of contributions that anyone can make. These are: Develop and share, Maintain and improve, Share resources, Review and update, Make it global through translation, and Share best practices

Contributions include development and sharing of new chapters; maintenance and improvement of existing chapters; sharing The Turing Way resources; review and updating of previously developed materials; translating its chapter to help make this project globally accessible, and sharing best practices in research.

Community members are provided with opportunities to learn new skills, share their ideas and collaborate with others. They are also given mentorship opportunities in the project as they make their contributions to The Turing Way or other open source projects and are encouraged to mentor new participants of the project.

We have created a promotion pack to help you in presenting and sharing about The Turing Way in your network.

Citing The Turing Way

We release the latest version of The Turing Way through the project's Zenodo archive using DOI: 10.5281/zenodo.3233853. This DOI is a "concept DOI" which means it will always resolve to the latest version. If you need to cite a specific version you can find those DOIs at the zenodo page above. 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 this:

The Turing Way Community. (2021, November 10). The Turing Way: A handbook for reproducible, ethical and collaborative research. Zenodo.

To see our workflow for making releases for different versions and to suggest improvements, please head over to the release workflow document.

You can share the human-readable URL to a page in the book, for example,, but be aware that the project is under development and therefore these links may update over time. You might want to include a web archive link such as 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.

Citing The Turing Way Illustrations

This is an example of one of The Turing Way illustrations. It tries to shows the evolution towards an open science era

The Turing Way illustrations are created by artists from Scriberia as part of The Turing Way book dashes in Manchester on 17 May 2019, London on 28 May 2019 and 21 February 2020, and online on 27th November 2020 and 28th May 2021. They depict a variety of content from the handbook, collaborative efforts in the community and The Turing Way project in general. These illustrations are available on Zenodo ( under a CC-BY license.

When using any of the images, please include the following attribution:

This image was created by Scriberia for The Turing Way community and is used under a CC-BY licence.

The latest version from Zenodo can be cited as:

The Turing Way Community, & Scriberia. (2021, May 29). Illustrations from the Turing Way book dashes. Zenodo.

We have used a few of these illustrations in the Welcome Bot's responses to new members' contributions in this GitHub repository.

Get in Touch


You can contact The Turing Way team by emailing [email protected].

You can also contact Anne Lee Steele ([email protected]), Malvika Sharan ([email protected]) or Kirstie Whitaker ([email protected]).


Connect with others and discuss your ideas on Slack using this invitation link.

We also have a Gitter chat room (if you prefer an open source alternative for chat) and we'd love for you to swing by to say hello at The room is also accessible with a Matrix account at

Recieve Updates

We have a tinyletter mailing list to which we send monthly project updates. Subscribe at

You can also follow us on Twitter (@turingway).


Thanks goes to these wonderful people (emoji key):

Aakash Raj

Abel Siqueira

Achintya Rao

Adina Wagner

Aditi Shenvi

Afzal Ansari


Ahmed Essam

Aida Mehonic

Albert Hornos Vidal

Alden Conner


Aleksandra Zaforemska

Alex Bird

Alex Chan

Alex Clarke

Alexander Morley

Ali Seyhun Saral

Ali Seyhun Saral

Ambreen Masud

Andrea Pierr

Andrea Snchez-Tapia (she/her)

Andreea Avramescu

Andrei Alexandru

Andrew Stewart

Andrian Nobella

Angelo Varlotta

Aniketh Varma

Anna Hadjitofi

Anna Krystalli

Annabel Elizabeth Whipp

Anne Fouilloux

Anne Lee Steele


Arron Lacey

Aryan nath

Augustinas Sukys

Barbara Vreede


Becki Green

Becky Arnold

Benjamin Mummery

Beth Montague-Hellen

Bouwe Andela

Brandon Lee

Brigitta Sipcz

Bruno Camino

Callum Mole

Cameron Trotter

Camila Rangel Smith

Carlos Martinez

Carlos Vladimiro Gonzlez Zelaya

Cassandra Gould van Praag

Cem Ulus

Chad Gilbert

Chandler Klein

Chanuki Illushka Seresinhe

Charlotte Watson

Chris Holdgraf

Chris Markiewicz

Chris Tomlinson

Christina Hitrova

Christopher Lovell

Clare Liggins

Colin Sauze

Collin Schwantes



Dan Hobley

Dan Kerchner

Danbee Kim

Daniel Lintott

Daniel Mietchen

Daniel Nst

Danny Garside

David Foster

David Gregg

David Stansby


Diego Alonso Alvarez

Dimitra Blana

Dinesh kumar

Edwin Ajong

Eirini Malliaraki

Eirini Zormpa


Elizabeth DuPre

Em K

Enrico Glerean

Eric Daub

Eric Leung

Eric R Scott

Esther Plomp

Evelina Gabasova

Faruk D.

Federico Nanni

Ferran Gonzalez Hernandez

Florian Gilcher

Frances Cooper

Frances Madden


Fuad Reza Pahlevi


Georgia Atkinson

Georgia Tomova

Georgiana Elena

Gertjan van den Burg

Gianni Scolaro

Graham Lee

Greg Kiar

Gustavo Becelli do Nacimento

Heidi Seibold

Hieu Hoang


Ian Hinder

Ikko Ashimine


Isil Bilgin



Jade Pickering

James Kent

James Myatt

James Robinson

James Thomas

Jamie J Quinn

Jason Gates

Javier Moldon

Jay Dev Jha

Jennifer Ding

Jeremy Crampton

Jeremy Leipzig


Jessy Provencher

Jez Cope

Jill Wang

Jim Circadian

Jim Madge

Joanna Leng

Joe Early

Joe Fennell

Johanna Bayer

Joshua Teves

Jos Mara Fernndez

Julia Guiomar Niso Galn

Julien Colomb


Katherine Dixey


Kesson Magid

Kevin Kunzmann

Kim De Ruyck

Kim De Ruyck

Kirstie Whitaker

Kristijan Armeni

Krunal Rank

Lachlan Mason

Laura Acion

Laura Carter


Liberty Hamilton


Louise Bowler


Luca Bertinetto

Luigi Scalzone

Luke Conibear


Lupe CaMay

Malvika Sharan

Marcos Ellys Rocha Honorato

Maria Eriksson

Maria del Mar Quiroga


Mariana V.


Mark Woodbridge

Markus Lning


Martin O'Reilly

Martina G. Vilas

Mateusz Kuzak

Matthew Evans

Max Joseph

Melissa Black

Michael Grayling

Miguel Rivera

Mustafa Anil Tuncel

Nadia Soliman

Naomi Penfold

Natacha Chenevoy

Natalie Thurlby

Nathan Begbie

Neha Moopen

Neil Chue Hong

Nick Barlow


Nicols Alessandroni


Nomi Harris


Obi Thompson Sargoni

Oleg Lavrovsky

Oliver Clark

Oliver Forrest

Oliver Hamelijnck

Oliver Strickson

Oscar Giles

Pablo Rodrguez-Snchez

Patricia Herterich

Patrick Mineault

Paul Dominick Baniqued

Paul Owoicho

Paula Andrea Martinez

Pedro Pinto da Silva


Philip Darke

Phillip Crout


Pierre Grimaud

Pooja Gadige

Pranav Mahajan

Przemek Dolata

Rachael Ainsworth

Radka Jersakova

Radovan Bast

Rafaela Queiroz

Rahul Thakare

Raniere Silva

Raul Palma

Reina Camacho Toro

Remi Gau

Reshama Shaikh

Richard Gilham

Richard Plant

Risa Ueno

Robert Precious

Robin Long

Rohit Midha

Romero Silva

Rose Sisk

Rosie Higman

Rosti Readioff


Samuel Guay

Samuel Nastase


Sangram K Sahu

Sarah Gibson

Sarah Stewart


Saranjeet Kaur

Sedar Olmez


Shankho Boron Ghosh

Sian Bladon

Siba Smarak Panigrahi

Simon Christ

Simon Duerr


Sophia Batchelor

Sophie J Mann


Srishti Nema

Stefan Janssen

Stefan Verhoeven

Stephan Druskat

Stephen Eglen

Sumera Priyadarsini

Susanna-Assunta Sansone

Sven van der Burg

Tania Allard

Tarek Allam

Tess Gough

Thomas Sandmann

Thya van den Berg

Tim Head

Tim Myers

Tim Powell

Tony Yang

Tushar Rohilla

Veronika Cheplygina


Victoria Dominguez del Angel

Warrick Ball

Wiebke Toussaint

Will Hulme

Wolmar Nyberg kerstrm

Xiaoqing Chen

Yanina Bellini Saibene

Yash Varshney


Yo Yehudi

Yu-Fang Yang

















































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

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Html (241,929
Team (16,057
Data Science (10,165
Readme (8,205
Education (7,661
Hut23 (67