Merge pull request #2614 from flodolo/update_comments

Improve localization comments

locales/en-US/webextension.properties

@@ -1,3 +1,4 @@
+# Clip in this context refers to a portion of an image
 addonDescription = Take clips and screenshots from the Web and save them temporarily or permanently.
 addonAuthorsList = Mozilla <screenshots-feedback@mozilla.org>
 toolbarButtonLabel = Take a shot
@@ -15,7 +16,9 @@ notificationLinkCopiedTitle = Link Copied
 # modifier key used in the shortcut (do not translate it): for example, Ctrl-V
 # on Windows systems.
 notificationLinkCopiedDetails = The link to your shot has been copied to the clipboard. Press {meta_key}-V to paste.
-# Error Strings
+# Section for error strings
+# "Out of order" is an humorous way to indicate that the service is not working
+# properly.
 requestErrorTitle = Out of order.
 requestErrorDetails = Sorry! We couldn’t save your shot. Please try again later.
 connectionErrorTitle = We can’t connect to your screenshots.
@@ -26,7 +29,7 @@ unshootablePageErrorDetails = This isn’t a standard Web page, so you can’t t
 selfScreenshotErrorTitle = You can’t take a shot of a Firefox Screenshots page!
 genericErrorTitle = Whoa! Firefox Screenshots went haywire.
 genericErrorDetails = We’re not sure what just happened. Care to try again or take a shot of a different page?
-# Onboarding Strings
+# Section for onboarding strings
 tourBodyOne = Take, save, and share screenshots without leaving Firefox.
 tourHeaderTwo = Capture Just What You Want
 tourBodyTwo = Click and drag to capture just a portion of a page. You can also hover to highlight your selection.
@@ -38,6 +41,11 @@ tourSkip = SKIP
 tourNext = Next Slide
 tourPrevious = Previous Slide
 tourDone = Done
+# Do not translate {termsAndPrivacyNoticeTermsLink} and
+# {termsAndPrivacyNoticyPrivacyLink}. They're placeholders replaced by links
+# using the corresponding translated strings as text.
 termsAndPrivacyNotice = By using Firefox Screenshots, you agree to the Screenshots {termsAndPrivacyNoticeTermsLink} and {termsAndPrivacyNoticePrivacyLink}.
+# This string is used as the text for a link in termsAndPrivacyNotice
 termsAndPrivacyNoticeTermsLink = Terms
+# This string is used as the text for a link in termsAndPrivacyNotice
 termsAndPrivacyNoticyPrivacyLink = Privacy Notice