The Turing Way: Introduction
===

###### tags: `turing-way` `document`

:::warning
### :warning: We now use the following welcome page to share links. This page may not be updated frequently: https://the-turing-way.start.page :warning:
:::

## Project information
:::info
- **Project:** The Turing Way
- **Project Co-Leads:** Dr. Kirstie Whitaker & Dr. Malvika Sharan ([e-mail])
- **Community Manager:** Anne Lee Steele ([e-mail])
- **Core Team Members:** [See the Team Document](https://github.com/alan-turing-institute/the-turing-way/blob/main/ways_of_working.md)
- **Contact:** [[e-mail]](mailto:[e-mail])
:::

:calendar: See upcoming opportunities to connect!
---

<iframe src="https://calendar.google.com/calendar/embed?height=600&wkst=1&bgcolor=%23ffffff&ctz=Europe%2FLondon&mode=AGENDA&src=dGhldHVyaW5nd2F5QGdtYWlsLmNvbQ&color=%230B8043" style="border:solid 1px #777" width="500" height="400" frameborder="0" scrolling="no"></iframe>

### Upcoming Turing Way Fireside Chat

==A community event series that features people, projects and communities in open and reproducible research.==

Join us on Thursday, 29 June at 14:00 UTC+1

**"Between computation, climate and culture: perspectives on sustainability and research"**

https://www.eventbrite.co.uk/e/between-computation-climate-and-culture-sustainability-and-research-tickets-662158412637

#### Attend the upcoming Fireside Chat (Upcoming in June)

- Info will be added

#### Book Dash call for applications are closed -- but you can join the two subevents!

* Pre Book Dash GitHub Skill-up (1.5 hours): 11 May 2023 <-- [SIGN UP](https://www.eventbrite.co.uk/e/the-turing-way-github-training-session-may-2023-tickets-608765011537) (open for everyone who'd like to join).
* The Turing Way community share-outs: 26 May 2023 <-- [SIGN UP](https://www.eventbrite.co.uk/e/608752574337) (open for everyone who'd like to join)

## ==Important Announcements this month==

* Read this month's newsletter: https://tinyletter.com/TuringWay/archive
* Centralised event document for 2023: https://docs.google.com/spreadsheets/d/1C-VZvmFL4PnSBsv_G9ZD3dwjIYLno3NyL7oHvbplnWs/edit#gid=577525947
* New illustrations released from 2022 Book Dash events: https://zenodo.org/record/7587336

:handshake: Connect with us!
---

Stay in touch through one of the many different channels below!

- [Slack workspace](https://tinyurl.com/jointuringwayslack)
- [Twitter account](https://twitter.com/turingway)
- Get in touch with _The Turing Way_ team: [Kirstie, Malvika and Anne](mailto:[e-mail])
- Read the [Contribution Guideline](https://github.com/alan-turing-institute/the-turing-way/blob/master/CONTRIBUTING.md)
- The Turing Way [Code of Conduct](https://the-turing-way.netlify.app/community-handbook/coc.html)
- Subscribe to [The Turing Way calendar](https://calendar.google.com/calendar?cid=dGhldHVyaW5nd2F5QGdtYWlsLmNvbQ)
- Subscribe to [monthly newsletters](https://tinyletter.com/TuringWay)
- Read [previous newsletters](https://tinyletter.com/TuringWay/archive)
- **Read all our [quarterly reports]**(https://github.com/alan-turing-institute/the-turing-way/tree/main/project_management/quarterly_reports)

We love hearing about how you're using _The Turing Way_ book and engaging in our community - please connect with us to share and highlight your work.

:wave: Join our Community Calls!
---
Join us at one of our weekly community calls. All are welcome, no prior sign-ups needed!
- **Coworking call** (every Monday at 11 BST): https://hackmd.io/@turingway/coworking-call
- **Collaboration Cafe** (bi-monthly on Wednesdays, 15-17 BST): https://hackmd.io/@turingway/collaboration-cafe
- **Office Hours** (weekly on Fridays, 11-13 BST): https://hackmd.io/@turingway/office-hours
- **Translation & Localisation weekly meet-up** (every Tuesday, 4pm-5pm BST): https://hackmd.io/j5EMbS6YTQOXPsh1RdxhXw
- The Translation of _The Turing Way_ details are provided here: https://github.com/alan-turing-institute/the-turing-way/pull/2202
- Please on Slack (#translation channel) to propose new languages or join the current translation teams.
- **Book Dash** (biannually - May and November)
- **Fireside Chats** (last Friday of every month at 4 BST): https://hackmd.io/@turingway/fireside-chats

:books: About
---

_The Turing Way_ is an open source community-driven book on reproducible, ethical and collaborative data science.
We involve and support a diverse community in participating, skill-building, exchanging ideas, developing resources and making data science inclusive as they collaborate with each other.

Our community members are learners, students, educators, researchers, policymakers, professionals, funders and more!

We look forward to welcoming you to the community!

- Explore the [GitHub repository](https://github.com/alan-turing-institute/the-turing-way)
- Read the book online: https://the-turing-way.netlify.app

:ballot_box_with_check: Quick links
---

- [About the project](https://www.turing.ac.uk/research/research-projects/turing-way-handbook-reproducible-data-science)
- [_The Turing Way_ book](https://the-turing-way.netlify.com)
- [GitHub repository](https://github.com/alan-turing-institute/the-turing-way)
- [Introductory YouTube Videos](https://www.youtube.com/playlist?list=PLBxcQEfGu3DkSOD-LbW5BxFIBvAgHvGHe)
- [5 min intro video - Kirstie Whitaker](https://www.youtube.com/watch?v=JyNhPfcBxTg&list=PLBxcQEfGu3DkSOD-LbW5BxFIBvAgHvGHe&index=2&t=16s)
- [6 min 2020 update video - Malvika Sharan](https://www.youtube.com/watch?v=etHzozIhPNY&list=PLBxcQEfGu3DkSOD-LbW5BxFIBvAgHvGHe&index=1&t=4s)

==Job Opportunities==
---

Lots of job opportunities to work at The Alan Turing Institute: https://cezanneondemand.intervieweb.it/turing/en/career#vacancies

Particularly, community manager positions at The Alan Turing Institute will work closely with *The Turing Way* team and project will be announced regularly!

Community Calls and Events
---
- [Fireside Chat](https://hackmd.io/@turingway/fireside-chats): Happens monthly to facilitate cross-community discussions on data science, research reproducibility, open science, ethics, collaboration and more! - look out for announcement on Eventbrite: [https://www.eventbrite.co.uk/o/the-turing-way-18600928389#events](https://www.eventbrite.co.uk/o/the-turing-way-18600928389#events)
- [Community coworking/online calls](https://the-turing-way.netlify.app/community-handbook/coworking.html):
- Weekly Co-Working calls
- Every Monday (11:00 - 12:00 London time)
- Shared notes: https://hackmd.io/@turingway/coworking-call
- Biweekly Collaboration cafes
- First and Third Wednesday (15:00 - 17:00)
- Shared notes: https://hackmd.io/@turingway/collaboration-cafe
- [Book Dash Events](https://the-turing-way.netlify.app/community-handbook/bookdash.html)
- Takes place 1-2 times a year, more engaged sprint for collaboration, networking and development
- Upcoming Book Dash in the [Twitter thread](https://twitter.com/turingway/status/1380125300865040385?s=20)

:hammer_and_wrench: Skill Building
---

- If you are new to Slack: [https://hackmd.io/@turingway/slack-guide](https://hackmd.io/@turingway/slack-guide)
- If you are new to HackMD, please see this document for a short guide (right click, open in a new window): https://hackmd.io/@turingway/hackmd-guide.
- Create a **GitHub account** if you don't have one: https://github.com
- If you are new to the GitHub, please check out these resources to familiarise yourself with GitHub:
- [GitHub Introductory Tutorial](https://malvikasharan.github.io/developing_collaborative_document/)
- The Turing Way chapter on [getting started with GitHub](https://the-turing-way.netlify.app/collaboration/github-novice.html)
- Markdown cheatsheet: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
- Video showing how to [open a new issue or pull request (PR) on GitHub](https://www.youtube.com/watch?v=YTbRzhQju4c)
- JupyterBook with Turing Way: https://github.com/jupytercon/jupyterbook-with-turing-way

### The Turing Way Guides

*Explore The Turing Way Guides - you contributions are welcome as these are always a work in progress!*

- [Guide for Reproducibility](https://the-turing-way.netlify.app/reproducible-research/reproducible-research.html)
- Learn about reproducibility, version control, licensing, data management, research environment, testing, reviewing and other best practices.
- [Guide to Collaboration](https://the-turing-way.netlify.app/collaboration/collaboration.html)
- Learn about how to use GitHub as new user, how to collaborate on GitHub, Managing new teams and development community, collaborate remotely (host meetings, organise events, attend meetings, design co-working calls, informal coffee chats etc.)
- [Guide for Ethical Research](https://the-turing-way.netlify.app/ethical-research/ethical-research.html)
- Learn what Ethical research mean and what ways and framework exist to conduct your research more ethically
- [Guide for Project Design](https://the-turing-way.netlify.app/project-design/project-design.html)
- Learn why project design aspects are important in data science and how you can apply good practices.
- [Guide for Communication](https://the-turing-way.netlify.app/communication/communication.html)
- Learn how you can communicate your research more effectively.
- [Community Handbook](https://the-turing-way.netlify.app/community-handbook/community-handbook.html)
- Learn about our community practices, templates and ways of working
- [Contributors Record](https://the-turing-way.netlify.app/afterword/contributors-record.html)
- All our contributors are acknowledged for their work. If you have participated in any way, your name should appear - if not, let the team know :)
- You can learn about how [we acknowledge different contributions](https://the-turing-way.netlify.app/community-handbook/acknowledgement.html)

### Training Materials

- Learn how to use Binder using [Zero to Binder tutorial](https://github.com/alan-turing-institute/the-turing-way/blob/master/workshops/boost-research-reproducibility-binder/workshop-presentations/zero-to-binder-python.md)
- Make your own The Turing Way Book using this Tutorial - [Creating a Jupyter Book with The Turing Way](https://github.com/jupytercon/2020-jupyterbook-with-turing-way)

## Representing _The Turing Way_

We invite you to represent _The Turing Way_ in your research community.
We have created a [promotion pack](https://github.com/alan-turing-institute/the-turing-way/tree/master/communications/promotion-pack) that links to various slidedecks that you can find on this [Google drive](https://drive.google.com/drive/folders/1mzGmbJkPnP5q1goQesxDc_E5zAPL0eTF?usp=sharing) and [Zenodo community page](https://zenodo.org/communities/the-turing-way/).

Here is short introduction slide for example:
<iframe src="https://docs.google.com/presentation/d/e/2PACX-1vSK-zDTKraDEbdMBJG-XHmMLdkcfKMR9v4Hca1tXkQwdqsWidLQd8LNArUy-xjM0X8sdAeaR90Q2-zD/embed?start=false&loop=false&delayms=3000" frameborder="0" width="960" height="569" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>

:confetti_ball: Get started with small contributions
---

🎊 *Every single contribution is valuable!* 🎊

* Read a chapter in our [online book](https://the-turing-way.netlify.app)
* Annotate using hypothes.is
* Create new issues using 'open an issue' button
* Suggest edit using 'suggest edit button'
* This can be fixing a typo, a broken link or adding further information to an existing chapters
* Suggest topics for new chapters (particularly if you can write them!) by [opening a new issue](https://github.com/alan-turing-institute/the-turing-way/issues/new?assignees=&labels=&template=CHAPTER_ISSUE_TEMPLATE.md) - read the description and replace *Lorem ipsum dolor sit amet, consectetur adipiscing.* with your suggestions
* Read what others are working on by exploring [Pull Requests](https://github.com/alan-turing-institute/the-turing-way/pulls)
* You can review pull requests (see [this page for details](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request))
* Submit a case study or your tips and tricks for reproducible research, see [this template](https://github.com/alan-turing-institute/the-turing-way/tree/master/book/templates/case-study-template)
* Flag the unclear or duplicated information in the book by opening an [issue on the GitHub](https://github.com/alan-turing-institute/the-turing-way/issues).
* Address an [old issue](https://github.com/alan-turing-institute/the-turing-way/issues) or comment on the the [pull requests](https://github.com/alan-turing-institute/the-turing-way/pulls).

*Let us know if you are struggling with contributing in any way so that we can provide specific support that can make you participation possible!*