You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/site/translation/getting-started/guide.md
+23-15Lines changed: 23 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -220,23 +220,30 @@ There are six columns in the Dashboard view.
220
220
221
221
Following are guidelines on best practices for handling items under each category in Dashboard.
222
222
223
-
-**Missing**
224
-
- These are items where there is no localization provided by any contributor. Click on the line to be taken to the item in the Survey Tool where items are highlighted and you can add a translation. When you fix a **Missing** item it will turn to **Changed**.
- The currently winning value has caused an error in validation that will have to be resolved before release. (High priority.)
227
+
- Fix the error. In some cases there is a conflict between items and you'll need to fix the conflicting item, not the one showing the error.
228
+
-**Missing**
229
+
- These are items where there is no localization provided by any contributor. Click on the line to be taken to the item in the Survey Tool where items are highlighted and you can add a translation. When you fix a **Missing** item it will turn to **Changed**.
228
230
-**Losing**
229
-
- These are items that you already voted on. This indicates that your vote is not for the currently winning value. If you can live with the winning item—if it is reasonable, even if you don't think it is optimal—change your vote to be for the winning item. If not, click the **Forum** button in the **Info Panel** and give reasons for people to change their vote to what you have suggested. If not all users have voted yet, these values may still be approved before the end of the cycle. **Engage with others on the Forum discussions**. Make sure to post the reasons why others should change their votes and **respond to others’ posts**.
231
+
- These are items that you have already voted on, but where your vote is not for the currently winning value. If you can live with the currently winning value — even if you don't think it is optimal, but reasonable — change your vote to be for the winning item. Otherwise, click the **Forum** button in the **Info Panel** and give reasons for why your fellow vetters should change their vote to what you have suggested. If others change their vote, the value may still be approved before the end of the cycle. **Engage with others on the Forum discussions**. Make sure to post good and verifiable arguments as to why others should change their votes and **respond to others’ posts**.
230
232
-**Disputed**
231
-
- This is very similar to **Losing**, except in this case your vote is winning and someone else's is losing. Review all of the items to see if someone else’s item is better and read the forum post, and whether you want to change your vote. Discuss in the forum, then use the Hide button to hide disputes you’ve addressed in the forum.
233
+
- This is similar to **Losing**, except in this case your value is winning and someone else's is losing. Review all of the items to see if someone else’s item is better and read the forum, and whether you want to change your vote. Discuss in the forum, then use the Hide button to hide disputes you’ve addressed in the forum.
232
234
-**Changed**
233
-
- The Changed count is provided in the Dashboard only as a reference. The **Changed** items are either:
234
-
- Missing items now have a value.
235
-
- The Winning value of the translation has been changed.
235
+
- The **Changed** items are either:
236
+
- Values that were missing translations now have a one.
237
+
- The Winning translation has been changed.
236
238
-**English Changed**
237
-
- These are items where the English source has changed after the last change in your language. Items that are listed in this section indicates that you need to re-check them and assess the impact to your language and update as appropriate. (Some English changes will have no impact to translations.)
239
+
- These are items where the English source has changed *after* the last change in translation. Items that are listed in this section indicates that you need to re-check them and assess the impact to your language and update as appropriate. (Sometimes English changes will have no impact to translations.)
238
240
-**Warnings**
239
-
- These are issues which appear after automatic checks. (For examples, a message could be "_The value is the same as English"_, which is a quite common warning for languages that are close to English in the spelling of languages or territories. If the value is actually ok, then click on the Hide button (crossed eye). If not, then vote for a fix, or post on the Forum for discussion.
241
+
- These are issues which appear after automatic checks. For example, a message could be "_The value is the same as English"_, which is a quite common warning for languages that are close to English in the spelling of languages or territories. If the value is actually valid, then click on the Hide button (crossed eye). If not, then vote for a fix, or post on the Forum for discussion.
242
+
-**Inherited Changed**
243
+
- The translated value is inherited from another value, and that value has changed. Ensure that the value is still suitable for inheritance.
244
+
-**Abstained**
245
+
- These are values where you and the org you represent have not provided any vote at all. It is best practice to have no abstained values for your language and coverage level to ensure high confidence in our release. (High priority.)
Copy file name to clipboardExpand all lines: docs/site/translation/getting-started/vetting-view.md
+10-3Lines changed: 10 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,21 +15,28 @@ The Dashboard will show you a list of data items with warnings of different kind
15
15
The Dashboard is divided in these sections. If a section is not visible for you, that means you have no items in that section:
16
16
17
17
-**Error**: The currently winning value has caused an error in validation that will have to be resolved before release. (High priority.)
18
-
- Fix the error. In some cases there is a conflict among items, and you'll need to fix the conflicting item, not the one showing the error.
18
+
- Fix the error. In some cases there is a conflict between items and you'll need to fix the conflicting item, not the one showing the error.
19
+
-**Missing**: These are items where there is no localization provided by any contributor. Click on the line to be taken to the item in the Survey Tool where items are highlighted and you can add a translation. When you fix a **Missing** item it will turn to **Changed**.
19
20
-**Losing**: Your vote is losing against the other vetters’ vote.
20
21
- Can you live with the winning value? If so, change your vote.
21
22
- Otherwise, use the forum to alert the other vetters and reach consensus.
22
23
-**Disputed**: Your vote is winning, but other vetters voted differently.
24
+
- Consider the alternate translation(s) and change your vote *if* the other is superior.
23
25
- Use the forum to help reach consensus if possible.
24
-
-**Warning**: The winning value has something unexpected in it, perhaps a character that’s not normally used in your language.
26
+
-**Warning**: Not an **Error**, but the winning value has something unexpected in it, perhaps a character that’s not normally used in your language.
25
27
- Please review. If it’s an unwarranted warning, you can hide it.
26
-
-**English Changed**: The English value changed from last version, but the winning translation in your language remained the same.
28
+
-**English Changed**: The English source value has changed since last version, but the winning translation in your language remained the same.
27
29
- Does the translation need to be updated? If not, you can hide the warning.
28
30
-**New**: The winning localized value is different from last year. (Informational.)
29
31
-**Missing**: We have no localized value for these values.
30
32
- Please provide them. (High priority.)
31
33
-**Provisional**: We have a value, but not enough votes to support it and include them in the release.
32
34
- Add your vote if you haven’t already and alert other vetters through the forum to support if you have already voted.
35
+
-**Inherited Changed**: The translated value is inherited from another value, and that value has changed.
36
+
- Ensure that the value is still suitable for inheritance.
37
+
-**Abstained**: These are values where you and the org you represent have not provided any vote at all.
38
+
- It is best practice to have no abstained values for your language and coverage level to ensure high confidence in our release. (High priority.)
0 commit comments