Comments for translators (#3729)

CONTRIBUTORS

@@ -203,6 +203,7 @@ hideo aoyama <https://github.com/boukendesho>
 Ross Brown <rbrownwsws@googlemail.com>
 🦙 <github.com/iamllama>
 Lukas Sommer <sommerluk@gmail.com>
+Lukas Sommer <sommerluk@users.noreply.github.com>
 Niclas Heinz <nheinz@hpost.net>
 Omar Kohl <omarkohl@posteo.net>
 David Elizalde <david.elizalde.r.a@gmail.com>

ftl/core/actions.ftl

@@ -1,12 +1,16 @@
 actions-add = Add
-# In the browser sidebar, when in "Select" mode, you can right-click on
+# Action in context menu:
-# selected criteria elements to create a search term that matches
+# In the browser sidebar, when in "Select" mode, right-click on the
-# cards/notes meeting ALL the selected criteria elements.
+# selected criteria elements. In the context menu, click on "Search" to open
+# a submenu. This entry in the submenu creates a search term that matches
+# cards/notes meeting ALL of the selected criteria.
 # https://github.com/ankitects/anki/pull/1044
 actions-all-selected = All selected
-# In the browser sidebar, when in "Select" mode, you can right-click on
+# Action in context menu:
-# selected criteria elements to create a search term that matches
+# In the browser sidebar, when in "Select" mode, right-click on the
-# cards/notes meeting ANY of the selected criteria elements.
+# selected criteria elements. In the context menu, click on "Search" to open
+# a submenu. This entry in the submenu creates a search term that matches
+# cards/notes meeting ANY of the selected criteria.
 # https://github.com/ankitects/anki/pull/1044
 actions-any-selected = Any selected
 actions-cancel = Cancel
@@ -67,9 +71,12 @@ actions-previous-card-info = Previous Card Info
 actions-with-ellipsis = { $action }...
 actions-fullscreen-unsupported = Full screen mode is not supported for your video driver. Try switching to a different one from the preferences screen.
 
-## Flags
-
 actions-flag-number = Flag { $number }
+
+## The same translation may used for two independent actions:
+## searching for cards with a flag of the specified color, and
+## toggling the flag of the specified color on a card.
+
 actions-flag-red = Red
 actions-flag-orange = Orange
 actions-flag-green = Green
@@ -77,6 +84,9 @@ actions-flag-blue = Blue
 actions-flag-pink = Pink
 actions-flag-turquoise = Turquoise
 actions-flag-purple = Purple
+
+##
+
 actions-set-flag = Set Flag
 actions-nothing-to-undo = Nothing to undo
 actions-nothing-to-redo = Nothing to redo

ftl/core/browsing.ftl

@@ -28,6 +28,7 @@ browsing-cards-deleted-with-deckname =
 browsing-change-deck = Change Deck
 browsing-change-deck2 = Change Deck...
 browsing-change-note-type = Change Note Type
+# Action in a context menu (right mouse-click on a card type)
 browsing-change-note-type2 = Change Note Type...
 browsing-change-notetype = Change Note Type
 browsing-clear-unused-tags = Clear Unused Tags

ftl/core/deck-config.ftl

@@ -463,12 +463,18 @@ deck-config-days-to-simulate = Days to simulate
 deck-config-desired-retention-below-optimal = Your desired retention is below optimal. Increasing it is recommended.
 deck-config-fsrs-simulator-y-axis-title-time = Review Time/Day
 deck-config-fsrs-simulator-y-axis-title-count = Review Count/Day
+# Description of the y axis in the FSRS simulation
+# diagram (Deck options -> FSRS) showing the total number of
+# cards that can be recalled or retrieved on a specific date.
 deck-config-fsrs-simulator-y-axis-title-memorized = Memorized Total
 deck-config-fsrs-simulator-experimental = FSRS simulator (experimental)
 deck-config-additional-new-cards-to-simulate = Additional new cards to simulate
 deck-config-simulate = Simulate
 deck-config-clear-last-simulate = Clear last simulation
 deck-config-fsrs-simulator-radio-count = Reviews
+# Radio button in the FSRS simulation diagram (Deck options -> FSRS) selecting
+# to show the total number of cards that can be recalled or retrieved on a
+# specific date.
 deck-config-fsrs-simulator-radio-memorized = Memorized
 
 ## NO NEED TO TRANSLATE. This text is no longer used by Anki, and will be removed in the future.

ftl/core/statistics.ftl

@@ -43,6 +43,24 @@ statistics-in-time-span-years =
         [one] in { $amount } year
        *[other] in { $amount } years
     }
+# Shown at the bottom of the deck list, and in the statistics screen.
+# eg "Studied 3 cards in 13 seconds today (4.33s/card)."
+# The { statistics-in-time-span-seconds } part should be pasted in from the English
+# version unmodified.
+statistics-studied-today =
+    Studied { statistics-cards }
+    { $unit ->
+        [seconds] { statistics-in-time-span-seconds }
+        [minutes] { statistics-in-time-span-minutes }
+        [hours] { statistics-in-time-span-hours }
+        [days] { statistics-in-time-span-days }
+        [months] { statistics-in-time-span-months }
+       *[years] { statistics-in-time-span-years }
+    } today
+    ({ $secs-per-card }s/card)
+
+##
+
 statistics-cards =
     { $cards ->
         [one] { $cards } card
@@ -59,22 +77,10 @@ statistics-reviews =
         [one] { $reviews } review
        *[other] { $reviews } reviews
     }
+# This fragment of the tooltip in the FSRS simulation
+# diagram (Deck options -> FSRS) shows the total number of
+# cards that can be recalled or retrieved on a specific date.
 statistics-memorized = {$memorized} memorized
-# Shown at the bottom of the deck list, and in the statistics screen.
-# eg "Studied 3 cards in 13 seconds today (4.33s/card)."
-# The { statistics-in-time-span-seconds } part should be pasted in from the English
-# version unmodified.
-statistics-studied-today =
-    Studied { statistics-cards }
-    { $unit ->
-        [seconds] { statistics-in-time-span-seconds }
-        [minutes] { statistics-in-time-span-minutes }
-        [hours] { statistics-in-time-span-hours }
-        [days] { statistics-in-time-span-days }
-        [months] { statistics-in-time-span-months }
-       *[years] { statistics-in-time-span-years }
-    } today
-    ({ $secs-per-card }s/card)
 statistics-today-title = Today
 statistics-today-again-count = Again count:
 statistics-today-type-counts = Learn: { $learnCount }, Review: { $reviewCount }, Relearn: { $relearnCount }, Filtered: { $filteredCount }
@@ -92,6 +98,12 @@ statistics-counts-learning-cards = Learning
 statistics-counts-relearning-cards = Relearning
 statistics-counts-title = Card Counts
 statistics-counts-separate-suspended-buried-cards = Separate suspended/buried cards
+
+## True Retention represents your actual retention rate from past reviews, in
+## comparison to the "desired retention" parameter of FSRS, which forecasts
+## future retention. True Retention is the percentage of all reviewed cards
+## that were marked as "Hard," "Good," or "Easy" within a specific time period.
+
 statistics-true-retention-title = True Retention
 statistics-true-retention-subtitle = Pass rate of cards with an interval ≥ 1 day.
 statistics-true-retention-range = Range
@@ -106,7 +118,12 @@ statistics-true-retention-week = Last week
 statistics-true-retention-month = Last month
 statistics-true-retention-year = Last year
 statistics-true-retention-all-time = All time
+# If there are no reviews within a specific time period, the retention
+# percentage cannot be calculated and is displayed as "N/A."
 statistics-true-retention-not-applicable = N/A
+
+##
+
 statistics-range-all-time = all
 statistics-range-1-year-history = last 12 months
 statistics-range-all-history = all history