[tor-bugs] #23226 [Applications/GetTor]: GetTor help message could be more helpful

[Tor Bug Tracker & Wiki]

#23226: GetTor help message could be more helpful
--------------------------------------------+------------------------
 Reporter:  catalyst                        |          Owner:  (none)
     Type:  defect                          |         Status:  new
 Priority:  Medium                          |      Milestone:
Component:  Applications/GetTor             |        Version:
 Severity:  Normal                          |     Resolution:
 Keywords:  anti-censorship-roadmap-2020Q1  |  Actual Points:
Parent ID:  #9036                           |         Points:  1
 Reviewer:                                  |        Sponsor:
--------------------------------------------+------------------------

Comment (by cohosh):

 I'd suggest keeping the help message simple, and then including
 instructions for verifying signatures in the actual links email. That way
 users don't get overwhelmed or confused about what a signature is before
 they see that it is an additional file they download. I think we should
 use the same approach for bridge instructions.

 Here's what I'd suggest for a help message email:

 {{{

 Hi! Welcome to GetTor!

 GetTor provides links and download instructions for Tor Browser.

 Please reply to this message with one of the options below:

     windows
     linux
     osx

 We will then send you the download instructions.

 You can also specify a locale for your Tor Browser download. We currently
 support
 the following locales:
 en-US, es-ES, pt-BR, ar, ca, cs, da, de, el, es-AR, fa, fr, ga-IE, he, hu,
 id, is,
 it, ja, ka, ko, nb-NO, nl, pl, ru, sv-SE, tr, vi, zh-CN, zh-TW

 --
 GetTor
 }}}

 And the links email:

 {{{
 Hi! Welcome to GetTor!

 You requested Tor Browser for linux.

 Step 1: Download Tor Browser

 You will need only one of the links below. If a link does not work for
 you,
 try the next one.

 GitLab: https://gitlab.com/thetorproject/torbrowser-linux/raw/master/tor-
 browser-linux64-9.0.4_en-US.tar.xz
 Signature file: https://gitlab.com/thetorproject/torbrowser-
 linux/raw/master/tor-browser-linux64-9.0.4_en-US.tar.xz.asc

 Github: https://github.com/torproject/torbrowser-
 releases/releases/download/torbrowser-release/tor-browser-linux64-9.0
 .4_en-US.tar.xz
 Signature file: https://github.com/torproject/torbrowser-
 releases/releases/download/torbrowser-release/tor-browser-linux64-9.0
 .4_en-US.tar.xz.asc

 If you have issues with any of the links above you can access the
 following
 archives and download the file: tor-browser-linux64-9.0.4_en-US.tar.xz

 - Internet Archive: https://archive.org/details/@gettor

 - Google Drive folder:
 https://drive.google.com/open?id=13CADQTsCwrGsIID09YQbNz2DfRMUoxUU


 Step 2: Verify the signature (Optional)

 Verifying the signature ensures that a certain package was generated by
 its
 developers and has not been tampered with. In GetTor emails we provide a
 link
 to a file with the same name as the package and the extension ".asc".
 These
 .asc files are OpenPGP signatures.

 < Include os-specific instructions here >


 Step 3: Get Bridges

 Bridge relays are Tor relays that are not listed in the public Tor
 directory.
 That means that ISPs or governments trying to block access to the Tor
 network
 can't simply block all bridges. Tor Browser comes with several built-in
 bridges.
 If Tor is censored in your country, you may need to request additional
 bridges
 from BridgeDB.

 If the built-in bridges do not work for you, send an email to
 bridges at torproject.org.
 Please note that you must send the email using an address from one of the
 following
 email providers: Riseup or Gmail.

 --
 GetTor
 }}}

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/23226#comment:11>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online