Opened 22 months ago

Closed 3 weeks ago

#22402 closed task (fixed)

Usablity and accessiblity improvement on the Tor assistant page

Reported by: iry Owned by: linda
Priority: Medium Milestone: website redesign
Component: Applications/Tor Launcher Version:
Severity: Normal Keywords: ux-team, TorBrowserTeam201903R
Cc: iry, mcs, adrelanos, tbb-team Actual Points:
Parent ID: #23266 Points:
Reviewer: Sponsor:

Description

The current version of Tor Launcher shows "For assistance, visit torproject.org/about/contact.html#support". The link is usually used by users who meet trouble in configuring the Tor using the Tor Launcher.

However, there are two problems with that:

  1. The webpage is hosted on Tor official website, which means users who live in heavily censored area may not be able to access the webpage directly.
  2. Even if they can access the webpage, the instruction is too general to solve their most likely problem which is how to configure the Tor Launcher.

Child Tickets

Change History (17)

comment:1 Changed 22 months ago by iry

For the first issue, it may be a good idea to Unblock Tor assistance webpage by collateral freedom. That is to say, we may host a mirror assistant page on website like Github which is "too expensive to block" by a censor. Tor has already had some positive attempt to unblock the content by collateral freedom. One example is the gettorbrowser page hosted on Github: https://github.com/TheTorProject/gettorbrowser

For the second issue, although the best hope is that the instruction provided by Tor Launcher is clear enough for helping users configure the Tor, it will still be helpful to provide a detailed tutorial webpage on how to use Tor launcher in different cases.

comment:2 Changed 22 months ago by iry

Cc: iry added
Keywords: ux-team added

comment:3 Changed 22 months ago by mcs

Cc: mcs added

comment:4 Changed 22 months ago by adrelanos

Cc: adrelanos added

comment:5 in reply to:  1 Changed 21 months ago by linda

Replying to iry:

For the first issue, it may be a good idea to Unblock Tor assistance webpage by collateral freedom. That is to say, we may host a mirror assistant page on website like Github which is "too expensive to block" by a censor. Tor has already had some positive attempt to unblock the content by collateral freedom. One example is the gettorbrowser page hosted on Github: https://github.com/TheTorProject/gettorbrowser

I agree! For now, we can set up a github page with just the part of the Tor Browser manual that has details on how to download, install, and configure a connection to Tor.

Additionally, we are creating a support portal to answer user questions and plan to have this mirrored. But that's a long-term project that will take a year or so.

For the second issue, although the best hope is that the instruction provided by Tor Launcher is clear enough for helping users configure the Tor, it will still be helpful to provide a detailed tutorial webpage on how to use Tor launcher in different cases.

We're working to improve tor launcher already! see here.

comment:6 Changed 21 months ago by cypherpunks

Also, if possible the assistance URL should be a direct link (it isn't at least on macOS, it's just text).

comment:7 Changed 20 months ago by linda

Parent ID: #21951#23266
Type: projecttask

23266

comment:8 Changed 17 months ago by iry

Also, if possible the assistance URL should be a direct link (it isn't at least on macOS, it's just text).

Hi @cypherpunks !

Sorry for taking so long to discuss about this. I may be wrong but is it possible that the designers do not make it a direct link intentionally?

Making the link plain text will require users to copy and paste it to a browser, but it also prevents users from accidentally clicking on that link. And some users may prefer open that link in a different environment or a browser which is not default?

Making the link a direct one seems to preserve the way for user to copy and paste, but it may be so easy to click on that link by accident when trying to select the link?

Clicking on the link and open it in a default browser may be dangerous for some users, especially for those who live in a censored area where they need Tor Bridge to connect to the Tor network. It will let an adversary know that the user is trying to access torproject.org through their internet traffic, or leave a browser history accessing torproject.org on their local browser, while the user really need to hide the fact he/she is trying to use Tor?

What do you think, cypherpunks? :)

comment:9 Changed 17 months ago by linda

Ah, I hadn't considered all of this, since I wasn't here when this decision was made. We should definitely consider iry's points before making it a link.

comment:10 Changed 14 months ago by cypherpunks

ticket:22402#comment:8

Clicking on the link and open it in a default browser may be dangerous for some users.... It will let an adversary know that the user is trying to access torproject.org through their internet traffic, or leave a browser history

This should be written above or below the text-link itself to warn users before they copy it. Or hide the link behind an "I'll be careful" or "I accept the risk" button like how Firefox does it on its about:config page.

comment:11 Changed 14 months ago by cypherpunks

we may host a mirror assistant page on website like Github which is "too expensive to block" by a censor.
open it in a default browser may be dangerous

Should Tor launcher display all mirrors then or only one? If one, torproject.org cannot be it because it isn't always safe, so then either it always has to be a collateral freedom mirror or Tor Launcher has to determine which link to display... which is probably impossible to do safely in this case when Tor isn't able to connect, so we're back to a collateral freedom mirror.

comment:12 Changed 14 months ago by cypherpunks

The link could instead open a minimal static local copy of the online documentation which could be bundled with Tor Browser explicitly for help configuring Tor Launcher and listing the same contact information for out-of-band support.

comment:13 Changed 12 months ago by hiro

Milestone: website redesign

comment:14 Changed 7 months ago by traumschule

Component: Webpages/WebsiteApplications/Tor Launcher

We could point to support.torproject.org now.

if possible the assistance URL should be a direct link

comment:15 Changed 3 weeks ago by antonela

comment:16 in reply to:  15 Changed 3 weeks ago by mcs

Cc: tbb-team added
Keywords: TorBrowserTeam201903R added
Status: newneeds_review

Replying to antonela:

We should link to https://support.torproject.org/#connectingtotor.

Here is a patch that updates the "For assistance" link inside Tor Launcher:
https://gitweb.torproject.org/user/brade/tor-launcher.git/commit/?h=bug22402-01&id=e4c4622a8e443a36480dacae3eee18d55a55a7ac

Tor Browser team: please review.

comment:17 Changed 3 weeks ago by gk

Resolution: fixed
Status: needs_reviewclosed

Looks good to me. Merged to master (commit e4c4622a8e443a36480dacae3eee18d55a55a7ac).

Note: See TracTickets for help on using tickets.