[tor-commits] [manual/translations] text updates since last year

emmapeel at torproject.org emmapeel at torproject.org
Wed Mar 3 14:45:04 UTC 2021 

commit 4f6c1c286edfa8261a3e44ab29a78e683b10d207
Author: emma peel <emma.peel at riseup.net>
Date:   Wed Mar 3 15:44:54 2021 +0100

    text updates since last year
---
 content/bridges/contents.lr             | 12 +++---
 content/downloading/contents.lr         |  4 +-
 content/installation/contents.lr        | 10 ++++-
 content/known-issues/contents.lr        | 25 ++++++++----
 content/managing-identities/contents.lr |  4 +-
 content/mobile-tor/contents.lr          | 72 ++++++++++++++++-----------------
 content/onion-services/contents.lr      | 54 +++++++++++++++++++++----
 content/running-tor-browser/contents.lr | 10 ++---
 content/security-settings/contents.lr   |  6 +--
 content/troubleshooting/contents.lr     | 41 +++++++++++++++----
 content/updating/contents.lr            |  6 +--
 11 files changed, 162 insertions(+), 82 deletions(-)

diff --git a/content/bridges/contents.lr b/content/bridges/contents.lr
index 608fc29..9512b1b 100644
--- a/content/bridges/contents.lr
+++ b/content/bridges/contents.lr
@@ -21,25 +21,25 @@ Other pluggable transports, like meek, use different anti-censorship techniques
 
 Because bridge addresses are not public, you will need to request them yourself. You have a few options:
 
- * Visit https://bridges.torproject.org/ and follow the instructions, or
- * Email bridges at torproject.org from a Gmail, or Riseup email address
+ * Visit [https://bridges.torproject.org/](https://bridges.torproject.org) and follow the instructions, or
+ * Email [bridges at torproject.org](mailto:bridges at torproject.org) from a Gmail, or Riseup email address
  * Use MOAT to fetch bridges from within Tor Browser.
 
 ### USING MOAT
 
-<img class="col-md-6" align="right" hspace="5" src="../../static/images/request-a-bridge.png">
+<img class="col-md-6" align="right" hspace="5" src="../../static/images/request-a-bridge.png" alt="Request a bridge from torproject.org">
 
 If you're starting Tor Browser for the first time, click "Configure" to open the Tor Network Settings window.
 After checking the checkbox "Tor is censored in my country," choose "Request a bridge from torproject.org" and click "Request a Bridge..." for BridgeDB to provide a bridge.
-Complete the CAPTCHA and click "Submit." Click "Connect" to save your settings.
+Complete the Captcha and click "Submit." Click "Connect" to save your settings.
 
 Or, if you have Tor Browser running, click on "Preferences" in the hamburger menu and then on "Tor" in the sidebar.
 In the "Bridges" section, check the checkbox "Use a bridge," and from the option "Request a bridge from torproject.org," click "Request a New Bridge..." for BridgeDB to provide a bridge.
-Complete the CAPTCHA and click "Submit." Your setting will automatically be saved once you close the tab.
+Complete the Captcha and click "Submit." Your setting will automatically be saved once you close the tab.
 
 ### ENTERING BRIDGE ADDRESSES
 
-<img class="col-md-6" align="right" hspace="5" src="../../static/images/tor-launcher-custom-bridges.png">
+<img class="col-md-6" align="right" hspace="5" src="../../static/images/tor-launcher-custom-bridges.png" alt="Enter custom bridge addresses">
 
 Once you have obtained some bridge addresses, you will need to enter them into Tor Launcher.
 
diff --git a/content/downloading/contents.lr b/content/downloading/contents.lr
index cda4563..e99fb6b 100644
--- a/content/downloading/contents.lr
+++ b/content/downloading/contents.lr
@@ -26,10 +26,10 @@ GetTor is a service that automatically responds to messages with links to the la
 
 ### TO USE GETTOR VIA EMAIL:
 
-Send an email to gettor at torproject.org, and in the body of the message simply write “windows”, “osx”, or “linux”, (without quotation marks) depending on your operating system.
+Send an email to [gettor at torproject.org](mailto:gettor at torproject.org), and in the body of the message simply write “windows”, “osx”, or “linux”, (without quotation marks) depending on your operating system.
 
 GetTor will respond with an email containing links from which you can download the Tor Browser package, the cryptographic signature (needed for verifying the download), the fingerprint of the key used to make the signature, and the package’s checksum. You may be offered a choice of “32-bit” or “64-bit” software: this depends on the model of the computer you are using.
 
 ### TO USE GETTOR VIA JABBER/XMPP (JITSI, COYIM, ETC.):
 
-To get links for downloading Tor Browser in Chinese for Linux, send a message to gettor at torproject.org with the words "linux zh" in it.
+To get links for downloading Tor Browser in Chinese for Linux, send a message to [gettor at torproject.org](mailto:gettor at torproject.org) with the words "linux zh" in it.
diff --git a/content/installation/contents.lr b/content/installation/contents.lr
index d50dd6a..80eef95 100644
--- a/content/installation/contents.lr
+++ b/content/installation/contents.lr
@@ -42,11 +42,17 @@ For GNU/Linux:
 
 4. When the download is complete, extract the archive with the command `tar -xf [TB archive]` or by using an archive manager.
 
-5. You'll need to tell your GNU/Linux that you want the ability to execute shell scripts from the graphical interface.
+5. You'll need to tell your GNU/Linux that you want the ability to execute shell scripts from the graphical interface or the command line.
    Navigate to the newly extracted Tor Browser directory.
    Right click on `start-tor-browser.desktop`, open Properties or Preferences and change the permission to allow executing file as program.
    Double-click the icon to start up Tor Browser for the first time.
 
+   **Note:** On Ubuntu and some other distros if you try to launch the start-tor-browser.desktop file a text file might open up.
+To change this behavior and launch Tor Browser instead, follow this: Open "Files" (GNOME Files/Nautilus) → open Preferences → go to the 'Behavior' Tab → Select "Run them" or "Ask what to do" under "Executable Text Files".
+If you choose the latter click on "Run" after launching the start-tor-browser.desktop file.
+
 6. Alternatively, from inside the Tor Browser directory, you can also start from the command line by running:
 
-   `./start-tor-browser`
+   `./start-tor-browser.desktop`
+
+See here on how to [update Tor Browser](https://tb-manual.torproject.org/updating/).
diff --git a/content/known-issues/contents.lr b/content/known-issues/contents.lr
index 1be38bf..a63c069 100644
--- a/content/known-issues/contents.lr
+++ b/content/known-issues/contents.lr
@@ -12,22 +12,33 @@ body:
 
 * Tor needs your system clock (and your time zone) set to the correct time.
 
-* The following firewall software have been known to interfere with Tor and may need to be temporarily disabled:
+* Antivirus or malware protection blocking users from accessing Tor Browser.
+Sometimes these also pop up with [false positives regarding malware and/or vulnerabilities](https://support.torproject.org/tbb/antivirus-false-positive/).
+You can read more about this on our [Support Portal](https://support.torproject.org/tbb/tbb-10/).
+The following antivirus and firewall software have been known to interfere with Tor and may need to be temporarily disabled:
   * Webroot SecureAnywhere
   * Kaspersky Internet Security 2012
   * Sophos Antivirus for Mac
   * Microsoft Security Essentials
+  * Avast Antivirus
 
-* Videos that require Adobe Flash are unavailable. Flash is disabled for security reasons.
+* VPNs also tend to interfere with Tor and need to be disabled.
+We also do not recommend using VPN and Tor together unless you're an advanced user who knows how to configure both in a way that doesn't compromise your privacy.
+You can find more detailed information about Tor + VPN at our [wiki](https://gitlab.torproject.org/legacy/trac/-/wikis/doc/TorPlusVPN).
+
+* Videos that require Adobe Flash are unavailable.
+Flash is disabled for security reasons.
 
 * Tor can not use a bridge if a proxy is set.
 
-* The Tor Browser package is dated January 1, 2000 00:00:00 UTC. This is to ensure that each software build is exactly reproducible.
+* The Tor Browser package is dated January 1, 2000 00:00:00 UTC.
+This is to ensure that each software build is exactly reproducible.
 
-* To run Tor Browser on Ubuntu, users need to execute a shell script. Open "Files" (Unity's explorer), open Preferences → Behavior Tab → Set "Run executable text files when they are opened" to "Ask every time", then click OK.
+* Issues with making Tor Browser as your [default browser](https://support.torproject.org/tbb/tbb-32/).
 
-* Tor Browser can also be started from the command line by running the following command from inside the Tor Browser directory:
+* If Tor Browser was working before and is not working now (especially after a re-install or an update), your system may have been hibernating.
+A reboot of your system, in that case, will solve the issue.
 
-	./start-tor-browser.desktop
+* Tor won't start on Windows when the [folder path contains non-ascii characters](https://gitlab.torproject.org/tpo/core/tor/-/issues/10416).
 
-* BitTorrent in specific is [not anonymous over Tor](https://blog.torproject.org/bittorrent-over-tor-isnt-good-idea).
+* BitTorrent [is not anonymous over Tor](https://blog.torproject.org/bittorrent-over-tor-isnt-good-idea).
diff --git a/content/managing-identities/contents.lr b/content/managing-identities/contents.lr
index 7fb5bf2..2a45462 100644
--- a/content/managing-identities/contents.lr
+++ b/content/managing-identities/contents.lr
@@ -20,7 +20,7 @@ Tor Browser centers your web experience around your relationship with the websit
 
 On the other hand, all connections to a single website address will be made over the same Tor circuit, meaning you can browse different pages of a single website in separate tabs or windows, without any loss of functionality.
 
-<img class="col-md-6" align="right" hspace="5" src="../../static/images/circuit_full.png">
+<img class="col-md-6" align="right" hspace="5" src="../../static/images/circuit_full.png" alt="Display circuit diagram under the site information menu">
 
 You can see a diagram of the circuit that Tor Browser is using for the current tab in the site information menu, in the URL bar.
 
@@ -39,7 +39,7 @@ When you log in to a website over Tor, there are several points you should bear
 
 ### CHANGING IDENTITIES AND CIRCUITS
 
-<img class="col-md-6" src="../../static/images/new_identity.png">
+<img style="max-width:100%" class="col-md-6" src="../../static/images/new_identity.png" alt="New Identity and New Tor Circuit options under main menu">
 
 Tor Browser features “New Identity” and “New Tor Circuit for this Site” options. There are also located in the main menu (hamburger menu).
 
diff --git a/content/mobile-tor/contents.lr b/content/mobile-tor/contents.lr
index f5eb373..1032a42 100644
--- a/content/mobile-tor/contents.lr
+++ b/content/mobile-tor/contents.lr
@@ -20,7 +20,7 @@ Some of the prime features of Tor Browser for Android include: reducing tracking
 
 There exists Tor Browser for Android and Tor Browser for Android (alpha).
 Non-technical users should get Tor Browser for Android, as this is stable and less prone to errors.
-Tor Browser for Android is available on Play Store, F-droid and the Tor Project website.
+Tor Browser for Android is available on Play Store, F-Droid and the Tor Project website.
 It is very risky to download Tor Browser outside of these three platforms.
 
 #### Google Play
@@ -31,7 +31,7 @@ You can install Tor Browser for Android from [Google Play Store](https://play.go
 The Guardian Project provides Tor Browser for Android on their F-Droid repository.
 If you would prefer installing the app from F-Droid, please follow these steps:
 
-1. Install the F-Droid app on your Android device from [the F-droid website.](https://f-droid.org/)
+1. Install the F-Droid app on your Android device from [the F-Droid website.](https://f-droid.org/)
 
 2. After installing F-Droid, open the app.
 
@@ -60,14 +60,14 @@ You can also get Tor Browser for Android by downloading and installing the apk f
 
 ### RUNNING TOR BROWSER FOR ANDROID FOR THE FIRST TIME
 
-When you run Tor Browser for the first time, you will see the  option to connect directly to the Tor network, or to configure Tor Browser for your connection with the settings icon.
+When you run Tor Browser for the first time, you will see the option to connect directly to the Tor network, or to configure Tor Browser for your connection with the settings icon.
 
 #### Connect
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-connect.png" alt="Connect to Tor Browser for Android">
 
 In most cases, choosing "Connect" will allow you to connect to the Tor network without any further configuration.
-Once clicked, changing sentences will appear at the bottom of the screen, indicating Tor’s connection progress.
+Once tapped, changing sentences will appear at the bottom of the screen, indicating Tor’s connection progress.
 If you are on a relatively fast connection, but this text seems to get stuck at a certain point, see the [Troubleshooting](../troubleshooting) page for help solving the problem.
 
 #### Configure
@@ -76,8 +76,8 @@ If you are on a relatively fast connection, but this text seems to get stuck at
 
 If you know that your connection is censored, you should select the settings icon.
 Tor Browser will take you through a series of configuration options.
-The first screen asks if access to the Tor network is blocked or censored on your connection.
-If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, click the switch.
+The first screen will tell you about the status of the Tor Network and provide you the option to configure a Bridge ('Config Bridge').
+If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, tap on 'Config Bridge'.
 You will then be taken to the [Circumvention](../circumvention) screen to configure a pluggable transport.
 
 ### CIRCUMVENTION
@@ -85,13 +85,13 @@ You will then be taken to the [Circumvention](../circumvention) screen to config
 Bridge relays are Tor relays that are not listed in the public Tor directory.
 Bridges are useful for Tor users under oppressive regimes, and for people who want an extra layer of security because they're worried somebody will recognize that they are contacting a public Tor relay IP address.
 
-To use a pluggable transport, click on the settings icon when starting Tor Browser for the first time.
-The first screen asks if access to the Tor network is censored on your connection. Click on the switch to toggle it.
+To use a pluggable transport, tap on the settings icon when starting Tor Browser for the first time.
+The first screen tells you about the status of the Tor network. Tap on 'Config Bridge' to configure a bridge.
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-censored.png" alt="Censored internet on Tor Browser for Android">
 
 The next screen provides the option to either use a built-in bridge or custom bridge.
-With the "Select a bridge" option, you will have two options: "obfs4" and "meek-azure".
+With the "Use a Bridge" option, you will have two options: "obfs4" and "meek-azure".
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-select-a-bridge.png" alt="Select a bridge on Tor Browser for Android">
 
@@ -111,7 +111,7 @@ If you choose the "Provide a Bridge I know" option, then you have to enter a [br
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-new-identity.png" alt="New Identity on Tor Browser for Android">
 
 When Tor Browser is running, you would see so in your phone's notification panel along with the button "NEW IDENTITY".
-Clicking on this button will provide you with a new identity.
+Tapping on this button will provide you with a new identity.
 Unlike in Tor Browser for Desktop, the "NEW IDENTITY" button in Tor Browser for Android does not prevent your subsequent browser activity from being linkable to what you were doing before.
 Selecting it will only change your Tor circuit.
 
@@ -119,13 +119,13 @@ Selecting it will only change your Tor circuit.
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-security-settings.gif" alt="Security settings and security slider on Tor Browser for Android">
 
-[Security settings](../security-settings/) disable certain web features that can be used to attack your security and anonymity.
+[Security settings](../security-settings/) disable certain web features that can be used to compromise your security and anonymity.
 Tor Browser for Android provides the same three security levels that are available on desktop.
 You can modify the security level by following given steps:
 
 * Tap on a button of 3 vertical dots in URL bar.
 * Scroll down and tap on "Security Settings".
-* You can now select an option from the security level slider.
+* You can now select an option i.e. Standard, Safer or Safest.
 
 
 ### UPDATING
@@ -133,21 +133,21 @@ Tor Browser must be kept updated at all times. If you continue to use an outdate
 You can update Tor Browser automatically or manually.
 
 #### Updating Tor Browser for Android automatically
-This method assumes that you have either Google Play or F-droid installed on your mobile device.
+This method assumes that you have either Google Play or F-Droid installed on your mobile device.
 
 ##### Google Play
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-update-google-play.png" alt="Updating Tor Browser for Android on Google Play">
 
-Click on the hamburger menu next to the search bar and navigate to "My apps & games" > "Updates".
-If you find Tor Browser on the list of apps which need updating, select it and click the "Update" button.
+Tap on the hamburger menu next to the search bar and navigate to "My apps & games" > "Updates".
+If you find Tor Browser on the list of apps which need updating, select it and tap the "Update" button.
 
 ##### F-Droid
 
-<img style="max-width:300px" class="col-md-6" src="../../static/images/android-update-f-droid.png" alt="Updating Tor Browser for Android on F-droid">
+<img style="max-width:300px" class="col-md-6" src="../../static/images/android-update-f-droid.png" alt="Updating Tor Browser for Android on F-Droid">
 
-Click on "Settings", then go to "Manage installed apps".
-On the next screen, select Tor Browser and finally click on the "Update" button.
+Tap on "Settings", then go to "Manage installed apps".
+On the next screen, select Tor Browser and finally tap on the "Update" button.
 
 #### Updating Tor Browser for Android manually
 
@@ -156,56 +156,52 @@ Visit the [Tor Project website](https://www.torproject.org/download/#android) an
 In most cases, this latest version of Tor Browser will install over the older version, thereby upgrading the browser.
 If doing this fails to update the browser, you may have to uninstall Tor Browser before reinstalling it.
 With Tor Browser closed, remove it from your system by uninstalling it using your device's settings.
-Depending on your mobile device's brand, navigate to Settings > Apps, then select Tor Browser and click on the "Uninstall" button. Afterwards,download the latest Tor Browser release and install it.
+Depending on your mobile device's brand, navigate to Settings > Apps, then select Tor Browser and tap on the "Uninstall" button. Afterwards, download the latest Tor Browser release and install it.
 
 
 ### UNINSTALLING
-Tor Browser for Android can be uninstalled directly from F-droid, Google Play or from your mobile device's app settings.
+Tor Browser for Android can be uninstalled directly from F-Droid, Google Play or from your mobile device's app settings.
 
 #### Google Play
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-google-play.png" alt="Uninstalling Tor Browser for Android on Google Play">
 
-Click on the hamburger menu next to the search bar and navigate to "My apps & games" > "Installed".
+Tap on the hamburger menu next to the search bar and navigate to "My apps & games" > "Installed".
 Select Tor Browser from the list of installed apps, then press the "Uninstall" button.
 
 #### F-Droid
 
-<img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-f-droid.png" alt="Uninstalling Tor Browser for Android on F-droid">
+<img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-f-droid.png" alt="Uninstalling Tor Browser for Android on F-Droid">
 
-Click on "Settings", then go to "Manage installed apps".
-On the next screen, select Tor Browser and finally click on the "Uninstall" button.
+Tap on "Settings", then go to "Manage installed apps".
+On the next screen, select Tor Browser and finally tap on the "Uninstall" button.
 
 #### Mobile device app settings
 
 <img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-device-settings.png" alt="Uninstalling Tor Browser for Android using device app settings">
 
-Depending on your mobile device's brand, navigate to Settings > Apps, then select Tor Browser and click on the "Uninstall" button.
+Depending on your mobile device's brand, navigate to Settings > Apps, then select Tor Browser and tap on the "Uninstall" button.
 
 ### KNOWN ISSUES
 
 At the moment, there are some features which are not available in Tor Browser for Android, but are currently available in Tor Browser for desktop.
 
-* You can't see your Tor circuit. [#25764](https://trac.torproject.org/projects/tor/ticket/25764)
-* Custom obfs4 bridges not working. [#30767](https://trac.torproject.org/projects/tor/ticket/30767)
-* 'Clear private data' option does not clear browsing history. [#27592](https://trac.torproject.org/projects/tor/ticket/27592)
-* Tor Browser for Android does not connect when moved to the SD Card. [#31814](https://trac.torproject.org/projects/tor/ticket/31814)
-* You can't take screenshots while using Tor Browser for Android. [#27987](https://trac.torproject.org/projects/tor/ticket/27987)
-* You can't save images. [#31013](https://trac.torproject.org/projects/tor/ticket/31013)
+* You can't see your Tor circuit. [#25764](https://gitlab.torproject.org/tpo/applications/torbutton/-/issues/25764)
+* Tor Browser for Android does not connect when moved to the SD Card. [#31814](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/31814)
+* You can't take screenshots while using Tor Browser for Android. [#27987](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/27987)  
+* Can't upload files with Tor Browser for Android. [#40283](https://gitlab.torproject.org/tpo/applications/tor-browser/-/issues/40283)
 
 ### More about Tor on mobile devices
 
 #### Orfox
 Orfox was first released in 2015 by The Guardian Project, with the aim of giving Android users a way to browse the internet over Tor.
-Over the next three years, Orfox continously improved and became a popular way for people to browse the internet with more privacy
-than standard browsers, and Orfox was crucial for helping people circumvent censorship and access blocked sites and critical resources.
-In 2019, [Orfox was sunsetted](https://blog.torproject.org/orfox-paved-way-tor-browser-android) after the official Tor Browser for
-Android was released.
+Over the next three years, Orfox continuously improved and became a popular way for people to browse the internet with more privacy than standard browsers, and Orfox was crucial for helping people circumvent censorship and access blocked sites and critical resources.
+In 2019, [Orfox was sunsetted](https://blog.torproject.org/orfox-paved-way-tor-browser-android) after the official Tor Browser for Android was released.
 
 #### Orbot
 Orbot is a free proxy app that empowers other apps to use the Tor network.
-Orbot uses Tor to encrypt your Internet traffic. Then you can use it with other apps installed on your mobile device to
-circumvent censorship and protect against surveillance.
+Orbot uses Tor to encrypt your Internet traffic.
+Then you can use it with other apps installed on your mobile device to circumvent censorship and protect against surveillance.
 Orbot can be downloaded and installed from [Google Play](https://play.google.com/store/apps/details?id=org.torproject.android).
 Check out [our Support portal](https://support.torproject.org/tormobile/tormobile-6/) to know if you need both Tor Browser for Android and Orbot or either one.
 
@@ -220,4 +216,4 @@ Download Onion Browser from the [App Store](https://itunes.apple.com/us/app/onio
 
 
 ### Tor Browser for Windows Phone
-There is currently no supported method for running Tor on Windows Phone.
+There is currently no supported method for running Tor on older Windows Phones but in case of the newer Microsoft-branded/promoted phones, same steps on [Tor Browser on Android](#tor-browser-for-android) can be followed.
diff --git a/content/onion-services/contents.lr b/content/onion-services/contents.lr
index 7f15915..8334f0c 100644
--- a/content/onion-services/contents.lr
+++ b/content/onion-services/contents.lr
@@ -10,24 +10,64 @@ key: 9
 ---
 body:
 
-Onion services (formerly known as “hidden services”) are services (like websites) that are only accessible through the Tor network.
+Onion services (formerly known as "hidden services") are services (like websites) that are only accessible through the Tor network.
 
 Onion services offer several advantages over ordinary services on the non-private web:
 
-* An onion services’s location and IP address are hidden, making it difficult for adversaries to censor it or identify its operators.
+* Onion services’ location and IP address are hidden, making it difficult for adversaries to censor them or identify their operators.
 * All traffic between Tor users and onion services is end-to-end encrypted, so you do not need to worry about [connecting over HTTPS](/secure-connections).
 * The address of an onion service is automatically generated, so the operators do not need to purchase a domain name; the .onion URL also helps Tor ensure that it is connecting to the right location and that the connection is not being tampered with.
 
 ### HOW TO ACCESS AN ONION SERVICE
 
-Just like any other website, you will need to know the address of an onion service in order to connect to it. An onion address is a string of 16 (and in V3 format, 56) mostly random letters and numbers, followed by “.onion”.
+Just like any other website, you will need to know the address of an onion service in order to connect to it. An onion address is a string of 16 (and in V3 format, 56) mostly random letters and numbers, followed by ".onion".
 
-When accessing a website that uses an onion service, Tor Browser will show at the URL bar an icon of a little green onion displaying the state of your connection: secure and using an onion service. And if you're accessing a website with https and onion service, it will show an icon of a green onion and a padlock.
+When accessing a website that uses an onion service, Tor Browser will show in the URL bar an icon of an onion displaying the state of your connection: secure and using an onion service.
+You can learn more about the onion site that you are visiting by looking at the Circuit Display.
+
+Another way to learn about an onion site is if the website administrator has implemented a feature called Onion-Location.
+Onion-Location is a non-standard HTTP header that websites can use to advertise their onion counterpart.
+If the website that you are visiting has an onion site available, a purple suggestion pill will prompt at the URL bar in Tor Browser displaying ".onion available".
+When you click on ".onion available", the website will be reloaded and redirected to its onion counterpart.
+
+<img style="max-width:100%" class="col-md-6" src="../../static/images/onion-location.png" alt="Onion-Location">
+
+To prioritize an onion site version of a website, you can enable automatic Onion-Location redirects.
+Click on hamburger menu (≡), go to Preferences (or Options on Windows), click on Privacy & Security, and in the Onion Services section look for the entry "Prioritize .onion sites when known." and check the option "Always".
+Or, if you're already running Tor Browser, you can copy and paste this string in a new tab: `about:preferences#privacy` and change this setting.
+
+## ONION SERVICE AUTHENTICATION
+
+An authenticated onion service is a service like an onion site that requires the client to provide an authentication token before accessing the service.
+As a Tor user, you may authenticate yourself directly in the Tor Browser.
+In order to access this service, you will need access credentials from the onion service operator.
+When accessing an authenticated onion service, Tor Browser will show in the URL bar an icon of a little gray key, accompanied by a tooltip.
+Enter your valid private key into the input field.
+
+<img style="max-width:100%" class="col-md-6" src="../../static/images/client-auth.png" alt="Client Authorization">
+
+### ONION SERVICES ERRORS
+
+If you can't connect to an onion site, Tor Browser will provide a specific error message informing why the website is unavailable. 
+Errors can happen in different layers: client errors, network errors or service errors.
+Some of these errors can be fixed by following the Troubleshooting section.
+The table below shows all the possible errors and which action you should take to solve the issue.
+
+| **Code** | **Error Title** | **Short Description** |
+|----------|-----------------|-----------------------|
+| XF0 | Onion site Not Found | The most likely cause is that the onion site is offline or disabled. Contact the onion site administrator. |
+| XF1 | Onion site Cannot Be Reached | The onion site is unreachable due to an internal error. |
+| XF2 | Onion site Has Disconnected | The most likely cause is that the onion site is offline or disabled. Contact the onion site administrator. |
+| XF3 | Unable to Connect to Onion site | The onion site is busy or the Tor network is overloaded. Try again later. |
+| XF4 | Onion site Requires Authentication | Access to the onion site requires a key but none was provided. |
+| XF5 | Onion site Authentication Failed | The provided key is incorrect or has been revoked. Contact the onion site administrator. |
+| XF6 | Invalid Onion site Address | The provided onion site address is invalid. Please check that you entered it correctly. |
+| XF7 | Onion site Circuit Creation Timed Out | Failed to connect to the onion site, possibly due to a poor network connection. |
 
 ### TROUBLESHOOTING
 
-If you cannot reach the onion service you require, make sure that you have entered the onion address correctly: even a small mistake will stop Tor Browser from being able to reach the site.
+If you cannot reach the onion service you requested, make sure that you have entered the onion address correctly: even a small mistake will stop Tor Browser from being able to reach the site.
 
-If you are still unable to connect to the onion service, please try again later. There may be a temporary connection issue, or the site operators may have allowed it to go offline without warning.
+If you are still unable to connect to the onion service after verifying the address, please try again later. There may be a temporary connection issue, or the site operators may have allowed it to go offline without warning.
 
-You can also ensure that you're able to access other onion services by connecting to [DuckDuckGo's Onion Service](http://3g2upl4pq6kufc4m.onion/).
+You can also test if you are able to access other onion services by connecting to [DuckDuckGo's Onion Service](http://3g2upl4pq6kufc4m.onion/).
diff --git a/content/running-tor-browser/contents.lr b/content/running-tor-browser/contents.lr
index 2de889c..708d277 100644
--- a/content/running-tor-browser/contents.lr
+++ b/content/running-tor-browser/contents.lr
@@ -15,7 +15,7 @@ This offers you the option to connect directly to the Tor network, or to configu
 
 ### CONNECT
 
-<img class="col-md-6" src="../../static/images/connect.png">
+<img class="col-md-6" src="../../static/images/connect.png" alt="Click 'connect' to connect to Tor.">
 
 In most cases, choosing "Connect" will allow you to connect to the Tor network without any further configuration.
 Once clicked, a status bar will appear, showing Tor’s connection progress.
@@ -23,22 +23,22 @@ If you are on a relatively fast connection, but this bar seems to get stuck at a
 
 ### CONFIGURE
 
-<img class="col-md-6" src="../../static/images/configure.png">
+<img class="col-md-6" src="../../static/images/configure.png" alt="Click 'configure' to adjust network settings.">
 
 If you know that your connection is censored or uses a proxy, you should select this option.
 
-<img class="col-md-6" src="../../static/images/proxy_question.png">
+<img class="col-md-6" src="../../static/images/proxy_question.png" alt="Select options for censored connection or proxy use.">
 
 Tor Browser will take you through a series of configuration options.
 
-<img class="col-md-6" src="../../static/images/pluggable-transport.png">
+<img class="col-md-6" src="../../static/images/pluggable-transport.png" alt="Configure Tor bridge options">
 
 The first checkbox asks if access to the Tor network is blocked or censored on your connection.
 If you do not believe this is the case, leave this unchecked.
 If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, check the checkbox.
 This will display the [Circumvention](../circumvention) section to configure a pluggable transport.
 
-<img class="col-md-6" src="../../static/images/proxy.png">
+<img class="col-md-6" src="../../static/images/proxy.png" alt="Configure proxy options">
 
 The second checkbox asks if your connection uses a proxy. In most cases, this is not necessary. You will usually know if you need to check this checkbox because the same settings will be used for other browsers on your system.
 If possible, ask your network administrator for guidance.
diff --git a/content/security-settings/contents.lr b/content/security-settings/contents.lr
index ade3242..3f93a0e 100644
--- a/content/security-settings/contents.lr
+++ b/content/security-settings/contents.lr
@@ -10,7 +10,7 @@ key: 11
 ---
 body:
 By default, Tor Browser protects your security by encrypting your browsing data.
-You can further increase your security by choosing to disable certain web features that can be used to attack your security and anonymity.
+You can further increase your security by choosing to disable certain web features that can be used to compromise your security and anonymity.
 You can do this by increasing Tor Browser's Security Levels in the shield menu.
 Increasing Tor Browser's security level will stop some web pages from functioning properly, so you should weigh your security needs against the degree of usability you require.
 
@@ -19,14 +19,14 @@ Increasing Tor Browser's security level will stop some web pages from functionin
 The Security Settings can be accessed by clicking the Shield icon next to the Tor Browser URL bar.
 To view and adjust your Security Settings, click the 'Advanced Security Settings...' button in the shield menu.
 
-<img class="col-lg-6" src="../../static/images/security-settings-anim.gif">
+<img style="max-width:100%" class="col-lg-6" src="../../static/images/security-settings-anim.gif" alt="Click on 'Advanced Security Settings' under the shield menu.">
 
 ### SECURITY LEVELS
 
 Increasing the Security Level in the Tor Browser Security Settings will disable or partially disable certain browser features to protect against possible attacks.
 You can enable these settings again at any time by adjusting your Security Level.
 
-<img class="col-lg-6" src="../../static/images/security-settings-safest.png">
+<img style="max-width:100%" class="col-lg-6" src="../../static/images/security-settings-safest.png" alt="Security Level is currently set to Standard.">
 
 
 ###### Standard
diff --git a/content/troubleshooting/contents.lr b/content/troubleshooting/contents.lr
index a1b2a93..757a345 100644
--- a/content/troubleshooting/contents.lr
+++ b/content/troubleshooting/contents.lr
@@ -11,22 +11,49 @@ key: 12
 body:
 You should be able to start browsing the web using Tor Browser shortly after running the program, and clicking the “Connect” button if you are using it for the first time.
 
-<img class="col-md-6" src="../../static/images/connect.png">
+<img class="col-md-6" src="../../static/images/connect.png" alt="Click 'Connect' to connect to Tor.">
 
 ### QUICK FIXES
 
-If Tor Browser doesn’t connect, there may be a simple solution. Try each of the following:
+If Tor Browser doesn’t connect, there may be a simple solution.
+Try each of the following:
 
 * Your computer’s system clock must be set correctly, or Tor will not be able to connect.
-* Make sure another Tor Browser is not already running. If you’re not sure if Tor Browser is running, restart your computer.
-* Make sure that any antivirus program you have installed is not preventing Tor from running. You may need to consult the documentation for your antivirus software if you do not know how to do this.
+* Make sure another Tor Browser or instance of 'Tor' is not already running on your system.
+  If you’re not sure if Tor Browser is running, restart your computer.
+* Make sure that any antivirus program you have installed is not preventing Tor from running.
+  You may need to consult the documentation for your antivirus software if you do not know how to do this.
 * Temporarily disable your firewall.
-* Delete Tor Browser and install it again. If updating, do not just overwrite your previous Tor Browser files; ensure they are fully deleted beforehand.
+* If Tor Browser was working before and is not working now your system may have been hibernating.
+  A reboot of your system will solve the issue.
+* Delete Tor Browser and install it again.
+  If updating, do not just overwrite your previous Tor Browser files; ensure they are fully deleted beforehand.
+
+### VIEW TOR LOGS
+
+In most cases, taking a look at the Tor logs can be helpful in diagnosing the issue.
+If you’re having trouble connecting, an error message may appear and you can select the option to "copy Tor log to clipboard".
+Then paste the Tor log into a text file or other document.
+
+If you don't see this option and you have Tor Browser open, you can navigate to the hamburger menu ("≡"), then click on "Preferences", and finally on "Tor" in the side bar.
+At the bottom of the page, next to the "View the Tor logs" text, click the button "View Logs...".
+
+Alternatively, on GNU/Linux, to view the logs right in the terminal, navigate to the Tor Browser directory and launch the Tor Browser from the command line by running:
+
+`./start-tor-browser.desktop --verbose`
+
+Or to save the logs to a file (default: tor-browser.log):
+
+`./start-tor-browser.desktop --log [file]`
+
+More information on this can be found on the [Support Portal](https://support.torproject.org/connecting/connecting-2/).
 
 ### IS YOUR CONNECTION CENSORED?
 
-If you still can’t connect, your Internet Service Provider might be censoring connections to the Tor network. Read the [Circumvention](/circumvention) section for possible solutions.
+If you still can’t connect, your Internet Service Provider might be censoring connections to the Tor network.
+Read the [Circumvention](/circumvention) section for possible solutions.
 
 ### KNOWN ISSUES
 
-Tor Browser is under constant development, and some issues are known about but not yet fixed. Please check the [Known Issues](/known-issues) page to see if the problem you are experiencing is already listed there.
+Tor Browser is under constant development, and some issues are known about but not yet fixed.
+Please check the [Known Issues](/known-issues) page to see if the problem you are experiencing is already listed there.
diff --git a/content/updating/contents.lr b/content/updating/contents.lr
index f856f63..6c5b14a 100644
--- a/content/updating/contents.lr
+++ b/content/updating/contents.lr
@@ -11,15 +11,15 @@ key: 12
 body:
 Tor Browser must be kept updated at all times. If you continue to use an outdated version of the software, you may be vulnerable to serious security flaws that compromise your privacy and anonymity.
 
-Tor Browser will prompt you to update the software once a new version has been released: the Torbutton icon will display a yellow triangle, and you may see a written update indicator when Tor Browser opens. You can update either automatically or manually.
+Tor Browser will prompt you to update the software once a new version has been released: the hamburger menu (main menu) will display a green circle with an upwards facing arrow in it, and you may see a written update indicator when Tor Browser opens. You can update either automatically or manually.
 
 ### UPDATING TOR BROWSER AUTOMATICALLY
 
-  <img width="400" src="../../static/images/update1.png" />
+  <img width="400" src="../../static/images/update1.png" alt="Select 'Restart to update Tor Browser' under the main menu"/>
 
 When you are prompted to update Tor Browser, click on hamburger menu (main menu), then select “Restart to update Tor browser”.
 
-  <img width="500" src="../../static/images/update4.png" />
+  <img width="500" src="../../static/images/update4.png" alt="Update progress bar"/>
 
 Wait for the update to download and install, then Tor Browser will restart itself. You will now be running the latest version.

More information about the tor-commits mailing list