Skip to content

Commit

Permalink
Merge pull request #70 from TWTranslation/translation-crowdin
Browse files Browse the repository at this point in the history
New Crowdin updates
  • Loading branch information
BatoolMM committed Nov 8, 2023
2 parents 9bb3549 + 8e5d4e5 commit 921ca67
Show file tree
Hide file tree
Showing 8 changed files with 78 additions and 98 deletions.
9 changes: 0 additions & 9 deletions book/website/_toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -651,8 +651,6 @@ parts:
file: ethical-research/activism/activism-whistleblowing
- title: Cultural change
file: ethical-research/activism/activism-cultural-change
- title: The Environmental Impact of Digital Research
file: ethical-research/activism/activism-env-impact
- title: Case study - Robodebt
file: ethical-research/activism/activism-robodebt
- title: Case study - Google Workers
Expand Down Expand Up @@ -746,13 +744,6 @@ parts:
file: community-handbook/infrastructure/infrastructure-contributors
- title: External Link Checking
file: community-handbook/infrastructure/infrastructure-external-link-check
- title: Communication Platforms
file: community-handbook/communication-platforms
sections:
- title: Slack Start Guide
file: community-handbook/communication-platforms/slack-start-guide
- title: Slack Welcome Guide
file: community-handbook/communication-platforms/slack-welcome-guide
- title: Monthly Newsletters
file: community-handbook/newsletters
sections:
Expand Down
134 changes: 62 additions & 72 deletions book/website/afterword/contributors-record.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion book/website/communication/os-comms.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ name: research-tools
width: 500px
alt: A few people are looking for different information about experiment, tools, privacy. There are different places or channels where these details can be identified, which is displayed in a findable manner.
---
Identifying the right channel to communicate and find information. _The Turing Way_ project illustration by Scriberia. Used under a CC-BY 4.0 licence. DOI: [10.5281/zenodo.3332807](https://doi.org/10.5281/zenodo.3332807).
Idetifying right channel to communicate and find information. _The Turing Way_ project illustration by Scriberia. Used under a CC-BY 4.0 licence. DOI: [10.5281/zenodo.3332807](https://doi.org/10.5281/zenodo.3332807).
```

## Motivation and Background
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,12 @@ The [workflow](https://github.com/the-turing-way/the-turing-way/blob/main/.githu
The schedule uses the [POSIX cron](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#schedule) format to specify when the workflow should run.
The workflow is currently configured to run once per week at midnight on Monday in the UTC+00:00 time zone.

[Lychee](https://lychee.cli.rs/) is used to check the book's external links _after_ building the book.
If the book fails to build then the workflow will also fail.
[Lychee](https://lychee.cli.rs/) is used to the books' external links _after_ building the book.
If the book fails to build then the workflow will fail.
The workflow uses cached results from previous runs to avoid the need to recheck all links every time the check is run.
However, this does mean that the results may not be up to date.
This does however mean that the results may not be up to date.

The GitHub runner's GitHub token is specified as an environment variable for the Lychee action.
The GitHub runners' GitHub token is specified as an environment variable for the Lychee action.
This prevents false negatives due to rate limiting when testing links to GitHub.

The [Lychee configuration](https://github.com/the-turing-way/the-turing-way/blob/main/lychee.toml) in the root of the repository controls the behaviour of Lychee.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Instead, we refer to a set of aspects that can lead to a successful and sustaina

Our current Translation Management System is Crowdin.
All translations are stored in a fork of _The Turing Way_ repository inside [TWTranslation](https://github.com/TWTranslation), a GitHub Organisation account.
This fork is updated regularly to fetch new content and Crowdin adds it automatically and starts an automatic translation based on machine translation and translation memory.
This fork is updated regularly to fetch new content and Crodin adds it automatically and starts an automatic translation based on machine translation and translation memory.
The automatic translations need review and approval before being accepted.

People in the team complete and review these automatic translations, according to the translation guidelines of each team.
Expand Down Expand Up @@ -63,13 +63,13 @@ alt: Crowdsourcing page in Crowdin which has three tabs, one showing the languag
- They are essential to harmonise and standardise translations.
Make sure you read them before you start translating for the first time.
If you are starting a new language, please make sure you create a repository in the GitHub organisation with your language guidelines.
Feel free to comment these guidelines and suggest new terms anytime. This can be done in the corresponding repositories or in _The Turing Way_ issues.
Feel free to comment these guidelines and suggest new terms anytime. This can be done in the corresponding repositories or in _The Turing Way_ issues

- **Choose the language you want to contribute to.** We have currently 4 languages with active contributors, which are Spanish, Arabic, Portuguese and Chinese.

```{admonition} Add A New Language
```{admonition} Add New Language
:class: tip
If your language is not in the list, please feel free to contact one of the managers and ask for a new language through Crowdin or Slack.
If your language is not in the list, please feel free to contact one of the managers and ask for new language through Crowdin or Slack.
```

```{figure} ../../figures/add-language-crowdin.gif
Expand Down Expand Up @@ -102,7 +102,7 @@ alt: You can add a new task to Crowdin by clicking on the console at the top and
```

- Once you decide which file you will work on, you can type its name in the search bar and click on it.
This will direct you to the Crowdin Editor, you will learn more about it in the next chapter.
This will direct you to Crowdin Editor, you will learn more about it in the next chapter.

```{admonition} Top Tip
:class: tip
Expand Down
1 change: 0 additions & 1 deletion book/website/ethical-research/activism.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,6 @@ Activism in your workplace can include:
* *{ref}`er-internal-policy`* campaigning to change the way your institution makes decisions or handles certain situations: this can include, for example, advocating for open data practices!
* *{ref}`er-activismwhistleblowing`* the act of alerting authorities or the press to problems in your institution
* *{ref}`er-activism-cultural-change`*: taking steps to change research/organisational culture
* *{ref}`er-activism-env-impact`*: consider the environmental impact of digital research.

In the future, we would like to expand this chapter to include guides to activism in wider society for scientists, for example, how to engage with government policy-making processes.

Expand Down
4 changes: 2 additions & 2 deletions book/website/reproducible-research/testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,14 +25,14 @@ Here's a couple of illustrations exemplifying of why should write tests:
```{figure} ../figures/testing-motivation1.*
---
name: testing-motivation1
alt: "Headline of a December 2006 news article by Greg Miller, published in Science, titled A Scientist's Nightmare: Software Problem Leads to Five Retractions"
alt:
---
```

```{figure} ../figures/testing-motivation2.*
---
name: testing-motivation2
alt: "News article by Lisa Grossman, published on Wired.com in November 2010, describing an inconsistency between the units of force expected as output and input of two pieces of software that resulted in the loss of a weather satellite when it reached its destination at Mars. The piece is titled November 10, 1999: Metric Math Mistake Muffed Mars Meteorology Mission"
alt:
---
```

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ The result may look like this:
```{figure} ../../figures/eyeball-test1.*
---
name: eyeball-test1
alt: Scatter plot of water level in a reservoir measured at regular intervals over 24 hours, where level remains fairly constant.
alt:
---
```

Expand All @@ -100,7 +100,7 @@ On a day with rain it might look like this:
```{figure} ../../figures/eyeball-test2.*
---
name: eyeball-test2
alt: Scatter plot of water level in a reservoir measured at regular intervals over 24 hours, where level increases steadily between 6am and 9pm before dropping slightly in the last 3-hour period.
alt:
---
```

Expand All @@ -109,7 +109,7 @@ and on a dry day it might look like this:
```{figure} ../../figures/eyeball-test3.*
---
name: eyeball-test3
alt: Scatter plot of water level in a reservoir measured at regular intervals over 24 hours, where level decreases steadily.
alt:
---
```

Expand All @@ -118,7 +118,7 @@ All of these outputs look very different but are valid. However, if a researcher
```{figure} ../../figures/eyeball-test-error.*
---
name: eyeball-test-error
alt: Scatter plot of water level in a reservoir measured at regular intervals over 24 hours, where fairly constant levels flank one very high measurement taken at midday.
alt:
---
```

Expand Down

0 comments on commit 921ca67

Please sign in to comment.