[tor-commits] [manual/develop] Add onion-location and new onion icons

[gus at torproject.org]

commit 98a165e433d6d6a40f3bca834bf36695e4a88ed7
Author: gus <gus at torproject.org>
Date:   Tue May 26 14:01:37 2020 -0400

    Add onion-location and new onion icons
---
 content/onion-services/contents.lr | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/content/onion-services/contents.lr b/content/onion-services/contents.lr
index 7f15915..be2ab9c 100644
--- a/content/onion-services/contents.lr
+++ b/content/onion-services/contents.lr
@@ -21,8 +21,14 @@ Onion services offer several advantages over ordinary services on the non-privat
 ### 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”.
-
-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.
+It's also possible to learn about an onionsite if the website administrator has advertised the onion version by enabling Onion-Location.
+Onion-Location is a new HTTP header that websites can use to advertise their onion counterpart.
+If the website that you're visiting has an onionsite available, a purple suggestion pill will prompt at the URL bar saying ".onion available".
+When you click on ".onion available", the website will be reloaded and redirected to its onion counterpart.
+To prioritize an onionsite version of a website, you can enable automatic Onion-Location redirects.
+Click on hamburger menu (≡), go to Preferences (or Options in Windows), click on Privacy & Security, and in Onion Services section check the option "Always".
+Or if you're already running Tor Browser, you can click directly here: [Privacy & Security](about:preferences#privacy).
+When accessing a website that uses an onion service, Tor Browser will show at the URL bar an icon of a little black onion displaying the state of your connection: secure and using an onion service. And if you're accessing a website using https and onion service, it will show an icon of a black onion and the organization's name. You can learn more about the onionsite you are visiting by looking at the Circuit Display.
 
 ### TROUBLESHOOTING