Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add instructions page for translations #175

Merged
merged 14 commits into from
Feb 1, 2023
14 changes: 6 additions & 8 deletions contributing/language-translations.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,15 @@

## Requirements
- GitHub account
reshamas marked this conversation as resolved.
Show resolved Hide resolved
- Knowledge of English and (Spanish or Portuguese)
- Knowledge of English
- Knowledge of Spanish or Portuguese

## About
We are using [Transifex](https://www.transifex.com/) to manage the language translations, which provides a translation infrastructure with Sphinx. Transifex is *a global content repository with a REST API, SDKs, automation, and more so you can centrally manage your source content and translations and build amazing multilingual digital experiences for your users.*

## Workflow

1. Create a [Transifex account](https://www.transifex.com/signin/).

Note: You can use your GitHub account to authenticate and log in to Transifex.
1. Create a [Transifex account](https://www.transifex.com/signin/). Note: You can use your GitHub account to authenticate and log in to Transifex.

2. Navigate to our project website: [pymc/data-umbrella-sprints-website](https://www.transifex.com/pymc/data-umbrella-sprints-website/)

Expand All @@ -24,16 +23,15 @@ Note: You can use your GitHub account to authenticate and log in to Transifex.

5. Pages to translate is a sub-menu under "Editor." Currently, these pages are being prioritized for translation: [priority pages](https://github.com/pymc-devs/pymc-data-umbrella/issues/99)

6. You can translate sub-sections and "Save translation."
6. You can translate sub-sections and select "Save translation."

:::{note}
There is a GitHub Actions that is configured on this repository, which turns a translation into a pull request which is submitted to the repository. [PR #166](https://github.com/pymc-devs/pymc-data-umbrella/pull/166/files) is an example pull request.
There is GitHub Actions that is configured on this repository, which turns a translation into a pull request which is submitted to the repository. [PR #166](https://github.com/pymc-devs/pymc-data-umbrella/pull/166/files) is an example pull request.
:::

## Translating content: volunteers needed

If you would to volunteer for translations, please select a page on [Issue #99](https://github.com/pymc-devs/pymc-data-umbrella/issues/99) on GitHub and indicate which page you will translate. A comment can be added to the issue. This will let other contributors know so that work is not duplicated.

If you would like to volunteer for translations, please select a page on [Issue #99](https://github.com/pymc-devs/pymc-data-umbrella/issues/99) on GitHub and indicate which page you will translate. A comment can be added to the issue. This will let other contributors know so that work is not duplicated.
reshamas marked this conversation as resolved.
Show resolved Hide resolved
reshamas marked this conversation as resolved.
Show resolved Hide resolved

## Thank you 🙌

Expand Down