From 97a3b3c1b3935c6ecd56fd1f7c4ba653fd00bd7e Mon Sep 17 00:00:00 2001
From: Sawyer Blatz <sdblatz@gmail.com>
Date: Fri, 8 Feb 2019 11:31:27 -0800
Subject: [PATCH] Closes #322: Adds missing string descriptions

---
 app/src/main/res/values/strings.xml | 93 +++++++++++++++--------------
 1 file changed, 47 insertions(+), 46 deletions(-)

diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 21ac8b3d6f..c7c6c4b944 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -2,18 +2,20 @@
    - License, v. 2.0. If a copy of the MPL was not distributed with this
    - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
 <resources>
+    <!-- Name of the application -->
     <string name="app_name">Fenix</string>
-    <string name="search_hint">Search the Web or enter address</string>
-    <string name="menu_share_with">Share with…</string>
-    <string name="browser_home_button">Home</string>
 
-    <!-- Home view -->
+    <!-- Home Fragment -->
     <!-- Content description (not visible, for screen readers etc.): "Three dot" menu button. -->
     <string name="content_description_menu">More options</string>
     <!-- Content description (not visible, for screen readers etc.): "Private Browsing" menu button. -->
     <string name="content_description_private_browsing_button">Enable Private Browsing</string>
+    <!-- Explanation for how sessions work -->
+    <string name="sessions_intro_description">Fenix will collect your browsing sessions on your Home Screen for you to retrieve later.</string>
+    <!-- Placeholder text shown in the search bar before a user enters text -->
+    <string name="search_hint">Search the Web or enter address</string>
 
-    <!-- Private browsing -->
+    <!-- Private Browsing -->
     <!-- Title for private session option -->
     <string name="private_browsing_title">Private Session</string>
     <!-- Explanation for private browsing displayed to users on home view when they first enable private mode -->
@@ -23,99 +25,98 @@
     <!-- Delete session button to erase your history in a private session -->
     <string name="private_browsing_delete_session">Delete Session</string>
 
-    <!-- Browser Menu -->
+    <!-- Browser Fragment -->
+    <!-- Content description (not visible, for screen readers etc.): Navigate home -->
+    <string name="browser_home_button">Home</string>
+    <!-- Content description (not visible, for screen readers etc.): Navigate backward (browsing history) -->
     <string name="browser_menu_back">Back</string>
+    <!-- Content description (not visible, for screen readers etc.): Navigate forward (browsing history) -->
     <string name="browser_menu_forward">Forward</string>
+    <!-- Content description (not visible, for screen readers etc.): Refresh current website -->
     <string name="browser_menu_refresh">Refresh</string>
+    <!-- Browser menu button that sends a user to help articles -->
     <string name="browser_menu_help">Help</string>
+    <!-- Browser menu button that opens the settings menu -->
     <string name="browser_menu_settings">Settings</string>
+    <!-- Browser menu button that opens a user's library -->
     <string name="browser_menu_library">Your Library</string>
+    <!-- Browser menu toggle that requests a desktop site -->
     <string name="browser_menu_desktop_site">Desktop Site</string>
+    <!-- Browser menu button that opens the find in page menu -->
     <string name="browser_menu_find_in_page">Find in Page</string>
+    <!-- Browser menu button that creates a private tab -->
     <string name="browser_menu_private_tab">Private Tab</string>
+    <!-- Browser menu button that creates a new tab -->
     <string name="browser_menu_new_tab">New Tab</string>
+    <!-- Browser menu button that opens a dialog to report issues with the current site -->
     <string name="browser_menu_report_issue">Report Site Issue</string>
+    <!-- Browser menu button that open a share menu to share the current site -->
     <string name="browser_menu_share">Share</string>
+    <!-- Share menu title, displayed when a user is sharing their current site -->
+    <string name="menu_share_with">Share with…</string>
 
-    <string name="sessions_intro_description">Fenix will collect your browsing sessions on your Home Screen for you to retrieve later.</string>
+    <!-- Search Fragment -->
+    <!-- Button in the search view that lets a user search by scanning a QR code -->
     <string name="search_scan_button">Scan</string>
+    <!-- Button in the search view that lets a user search by using a shortcut -->
     <string name="search_shortcuts_button">Shortcuts</string>
+    <!-- Button in the search view that lets a user navigate to the site in their clipboard -->
+    <string name="awesomebar_clipboard_title">Fill link from Clipboard</string>
 
-    <!-- Menu option on the toolbar that takes you to settings page-->
-    <string name="settings">Settings</string>
+    <!-- Library -->
+    <!-- Option in Library to open Sessions page -->
+    <string name="library_sessions">Sessions</string>
+    <!-- Option in Library to open Screenshots page -->
+    <string name="library_screenshots">Screenshots</string>
+    <!-- Option in Library to open Downloads page -->
+    <string name="library_downloads">Downloads</string>
+    <!-- Option in Library to open Favorites page -->
+    <string name="library_favorites">Favorites</string>
+    <!-- Option in Library to open History page -->
+    <string name="library_history">History</string>
+    <!-- Option in Library to open Logins page -->
+    <string name="library_logins">Logins</string>
 
-    <string name="awesomebar_clipboard_title">Fill link from Clipboard</string>
+    <!-- Settings Fragment -->
+    <!-- Title for the settings page-->
+    <string name="settings">Settings</string>
 
     <!-- Preferences -->
     <!-- Preference category for basic settings -->
     <string name="preferences_category_basics">Basics</string>
-
     <!-- Preference category for all links about Fenix -->
     <string name="preferences_category_about">About</string>
-
     <!-- Preference for settings related to changing the default search engine -->
     <string name="preferences_search_engine">Search engine</string>
-
     <!-- Preference linking to help about Fenix -->
     <string name="preferences_help">Help</string>
-
     <!-- Preference link to rating Fenix on the Play Store -->
     <string name="preferences_rate">Rate on Play Store</string>
-
     <!-- Preference for giving feedback about Fenix -->
     <string name="preferences_feedback">Give feedback</string>
-
     <!-- Preference linking to about page for Fenix -->
     <string name="preferences_about">About Fenix</string>
-
     <!-- Preference for settings related to saved passwords -->
     <string name="preferences_passwords">Passwords</string>
-
     <!-- Preference for settings related to saved credit cards and addresses -->
     <string name="preferences_credit_cards_addresses">Credit cards and addresses</string>
-
     <!-- Preference for settings related to changing the default browser -->
     <string name="preferences_set_as_default_browser">Set as default browser</string>
-
     <!-- Preference category for advanced settings -->
     <string name="preferences_category_advanced">Advanced</string>
-
     <!-- Preference for advanced site permissions -->
     <string name="preferences_site_permissions">Site permissions</string>
-
     <!-- Preference for accessibility -->
     <string name="preferences_accessibility">Accessibility</string>
-
     <!-- Preference category for account information -->
     <string name="preferences_category_account">Account</string>
-
     <!-- Preference shown on banner to sign into account -->
     <string name="preferences_sign_in">Sign in</string>
-
     <!-- Preference description for banner about signing in -->
-    <string name="preferences_sign_in_description">Get your tabs, bookmarks, logins, history and more on all your devices</string>
-
+    <string name="preferences_sign_in_description">Get your tabs, bookmarks, logins,
+        history and more on all your devices</string>
     <!-- Preference for language -->
     <string name="preferences_language">Language</string>
-
     <!-- Preference for data choices -->
     <string name="preferences_data_choices">Data choices</string>
-
-    <!-- Option in Library to open Sessions page -->
-    <string name="library_sessions">Sessions</string>
-
-    <!-- Option in Library to open Screenshots page -->
-    <string name="library_screenshots">Screenshots</string>
-
-    <!-- Option in Library to open Downloads page -->
-    <string name="library_downloads">Downloads</string>
-
-    <!-- Option in Library to open Favorites page -->
-    <string name="library_favorites">Favorites</string>
-
-    <!-- Option in Library to open History page -->
-    <string name="library_history">History</string>
-
-    <!-- Option in Library to open Logins page -->
-    <string name="library_logins">Logins</string>
 </resources>