Skip to content

Commit 5d13b27

Browse files
committed
review roles section
1 parent 2bbecbb commit 5d13b27

File tree

1 file changed

+22
-20
lines changed

1 file changed

+22
-20
lines changed

web/index.qmd

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -52,39 +52,41 @@ All outputs in base R and recommended packages (such as messages emitted by `sto
5252

5353
## Roles
5454

55-
We use the [dedicated reviewers](https://docs.weblate.org/en/latest/workflows.html#dedicated-reviewers)
56-
workflow on Weblate. We currently manage 3 roles in the platform. Languages without dedicated reviewers have their
57-
translations directly approved without review.
55+
Languages without an established translation team and so without dedicated reviewers have their translations directly approved without review.
56+
In that perspective, there's a single role for translators, and no reviewers.
57+
58+
In case a team has been established for a language, we use the [dedicated reviewers](https://docs.weblate.org/en/latest/workflows.html#dedicated-reviewers)
59+
workflow on Weblate, where we currently manage 3 roles in the platform.
5860

5961
### Translators
6062

61-
Every registered user on Weblate can act as a translator. All translations are reviewed unless there is
62-
no reviewer assigned for that language. If you are not sure about a translation you can make a suggestion instead. You
63+
Every registered user on Weblate can act as a translator for any language. All translations need to be reviewed unless there is
64+
no reviewer assigned for that language. If you are not sure about a translation, you can make a suggestion instead. You
6365
can also use the Glossary to check which terms you shouldn't translate and discuss with the community to add new ones if
6466
you don't find the word you are looking for.
6567

66-
### Admins/team leaders
67-
68-
Admins/team leaders keep the list of admins and reviewers by language up to date. The team
69-
leader(s) of a particular language is(are) the initial [dedicated
70-
reviewer(s)](https://docs.weblate.org/en/latest/workflows.html#dedicated-reviewers).
71-
7268
### Reviewers
7369

74-
Reviewers have an editor role who approves the work of translators and ensures the overall cohesion of the
75-
translation work in one language. For adding new reviewers or peer reviewers to Weblate, please reach out to the
70+
Reviewers bear the editor role to approve the work of translators and ensure the overall cohesion of the
71+
translation work in one language. For adding new reviewers for a language, please reach out to the
7672
respective team leaders via the `#core-translation` channel on the [R Contributors
7773
Slack](https://contributor.r-project.org/slack) workspace.
7874

75+
### Team leaders
76+
77+
Team administrators and leaders keep the list of admins and reviewers for a language up to date. The team
78+
leader(s) of a particular language is(are) the initial [dedicated
79+
reviewer(s)](https://docs.weblate.org/en/latest/workflows.html#dedicated-reviewers) as well.
80+
81+
## Translation states
82+
7983
Possible state of a string:
8084

81-
* **Untranslated**: Translation is empty, it might or not be stored in the file, depending on the file format.
82-
* **Needs editing**: Translation needs editing, this is usually the result of a source string
83-
change, fuzzy matching or translator action. **If you are unsure about how to translate something, make a suggestion,**
84-
**do not click the "Needs editing" button**.
85-
* **Waiting for review**: Translation is made, but not reviewed.
86-
* **Approved**:
87-
Translation has been approved in the review. It can no longer be changed by translators, but only by reviewers.
85+
* **Untranslated**: Translation is missing, and might or might not be stored in the translation file.
86+
* **Needs editing**: Translation needs editing. This is usually the result of a source string
87+
change, fuzzy matching or translator action. The `fuzzy` tag might be commited to the translation file. **If you are unsure about how to translate something, make a suggestion instead of clicking the "Needs editing" button**.
88+
* **Waiting for review**: Translation is made, but not reviewed yet.
89+
* **Approved**: Translation has been approved in the review. It can no longer be changed by translators, but only by reviewers. This is also committed to the repository.
8890

8991
## Sustainability of the translations community
9092

0 commit comments

Comments
 (0)