(welcome)=
# Welcome

*Welcome to The Turing Way handbook to reproducible, ethical and collaborative data science.*

test deploy 4

_The Turing Way_ is an open science, open collaboration, and community-driven project.
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, data scientists, software engineers, policymakers, and other practitioners in academia, industry, government and the public sector need to ensure that the projects they work on are easy to reproduce and reuse.

```{admonition} Top Tip
:class: tip
_The Turing Way_ is not meant to be read from start to finish.
Start with a concept, tool or method that you need now, in your current work.
Browse the different guides that make up the book, or use the search box to search for whatever you would like to learn about first.
```

All stakeholders from any level of experience or domain expertise are encouraged to use _The Turing Way_ to understand their roles and responsibility of reproducibility in data science and research.
You can inspect our resources on [GitHub](https://github.com/the-turing-way/the-turing-way), contribute to the project as described in our [contribution guidelines](https://github.com/the-turing-way/the-turing-way/blob/main/CONTRIBUTING.md) and re-use all materials ([see the License](https://github.com/the-turing-way/the-turing-way/blob/main/LICENSE.md)).

In the {ref}`Foreword Section<fw>` of this book, we provide meta-level information about _The Turing Way_, including guidance on how to use and navigate this project, how to cite the book and opportunities to get involved.

```{figure} figures/theturingway-pathway.*
---
name: welcome-image
alt: The Turing Way project is illustrated as 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.
---
_The Turing Way_ project illustration by Scriberia. Zenodo. [http://doi.org/10.5281/zenodo.3332807](http://doi.org/10.5281/zenodo.3332807)
```

The book is collaboratively written and built in the open from the start.
You can explore different opportunities to get involved on the [start page](https://the-turing-way.start.page/).
Join [our Slack Workspace](https://join.slack.com/t/theturingway/shared_invite/zt-fn608gvb-h_ZSpoA29cCdUwR~TIqpBw) to connect and discuss your ideas and [subscribe to our newsletter](https://buttondown.email/turingway) to follow updates from our community.

## Different Pathways
:::{panels}
:container: +full-width
:column: col-lg-6 px-2 py-2
:header: text-center bg-white
:card: text-left shadow
:footer: text-left
```{link-button} ./early-career-researchers.html
:text: Early Career Researchers
:classes: bg-info text-white text-center font-weight-bold
```
^^^
- [](project-design/project-design)
- [](collaboration/github-novice)
- [](project-design/project-repo)

And more... 

---
```{link-button} ./project-leaders.html
:text: Project Leaders
:classes: bg-info text-white text-center font-weight-bold
```
^^^
- [](collaboration/leadership)
- [](project-design/project-design)
- [](project-design/project-repo)

And more... 

---
```{link-button} ./research-software-engineers.html
:text: Research Software Engineers
:classes: bg-info text-white text-center font-weight-bold
```
^^^
- [](communication/citable/citable-cite)
- [](collaboration/research-infrastructure-roles/rse)
- [](collaboration/research-infrastructure-roles/rse-personal-story)

And more... 

---
```{link-button} ./software-citation.html
:text: Software Citation
:classes: bg-info text-white text-center font-weight-bold
```
^^^
- [](communication/citable/citable-steps)
- [](communication/citable/citable-cite)
- [](communication/citable/citable-cff)

And more... 

::: 


(welcome-community)=
## Our Community

_The Turing Way_ community is dedicated to making collaborative, reusable and transparent research "too easy not to do".
That means investing in the socio-technical skills required to work in a team, to build something more significant than any individual could deliver alone.

_The Turing Way_ is:

* a book
* a community
* a global collaboration

We hope you find the content in the book helpful.
Everything here is available for free under a [CC-BY licence](https://github.com/the-turing-way/the-turing-way/blob/main/LICENSE.md).
Please use and re-use whatever you need, for any purpose.

_The Turing Way_ receives support and funding from [The Alan Turing Institute](https://www.turing.ac.uk/), however, the project is designed to be a global collaboration.
We have contributions from across the UK, India, Mexico, Australia, the USA, some African countries, and many European countries.
Chapters have been written, reviewed and curated by members of research institutes and universities, government departments, and industry.
We are committed to creating a space where people with diverse expertise and experiences can share their knowledge with others, together supporting each other in using data science to improve the world.

```{admonition} Translation
:class: tip
Call for translators! We’re looking for contributors to help translate this space for everyone! Read more about our translation workflow and how you can contribute to it in the {ref}`translation chapter<ch-translation>`.
```

We value the participation of every member of our community and want to ensure that every contributor has an enjoyable and fulfilling experience.
Accordingly, everyone who participates in _The Turing Way_ project is expected to show respect and courtesy to other community members at all times.

Learn more about our community members and community-level approaches in the {ref}`aw` of this book. 

<video controls loop autoplay muted>
  <source src="_static/videos/contributors.mp4" type="video/mp4">
  <p>Video showing screen capture of contributors table, smiling faces and emojis representing the types of contributions in a table.</p>
</video>

To make this project truly accessible and useful for everyone, we invite you to contribute your skills and bring your perspectives into this project.

To join this community, please read our [contribution guidelines](https://github.com/the-turing-way/the-turing-way/blob/main/CONTRIBUTING.md) with ways to [get in touch](https://github.com/the-turing-way/the-turing-way#get-in-touch).
All contributions must abide by our [code of conduct](https://github.com/the-turing-way/the-turing-way/blob/main/CODE_OF_CONDUCT.md).
More information about the community, participation process and project management is available in the {ref}`ch`.

We look forward to expanding and building _The Turing Way_ together.

