Opened 8 weeks ago

Last modified 7 weeks ago

#31539 new enhancement

FAQ page (esp connection troubleshoooting) should be available offline in TB

Reported by: mrphs Owned by: tbb-team
Priority: Medium Milestone:
Component: Applications/Tor Browser Version:
Severity: Normal Keywords: censorship, support,
Cc: phw, ggus, antonela, pili Actual Points:
Parent ID: Points:
Reviewer: Sponsor: Sponsor30-can

Description (last modified by mrphs)

Tor has been once again blocked as of few hours ago in Iran. And as per usual my DMs and Email have been flooded with questions from censored users not knowing how to get back on the network. This means people still don't know they can use a bridge, or that there are default bridges provided, or that they can perform bridge discovery inside the Tor Browser.

One of the things I've always admired Tails for, is that all of their documentation is available offline inside Tails. We used to do a similar thing. In the old days, there was a short Tor Browser manual. A one page simple html that was served when someone would request TB via GetTor.

I think it wont hurt to load an offline HTML page in case connection fails, and users are confused on what to do next. In my experience, most users don't even know that there are other ways to connect to the Tor network when the direct connection fails.

Additionally, we should consider a scenario that I haven't seen covered by any of the help documents I've read so far and that is when a user has already been connecting to the Tor network directly, but after some time it fails and now they need a bridge.

I'm not sure which component would be the right one for this, considering it involves censorship circumvention, tor browser and tor support. Feel free to move it to the right bucket.

Child Tickets

Change History (9)

comment:1 Changed 8 weeks ago by mrphs

Description: modified (diff)
Type: defectenhancement

comment:2 Changed 8 weeks ago by mrphs

And the reason I mentioned FAQ page instead of https://tb-manual.torproject.org/bridges/ was because when you go to Tor Network Settings..., it says For assistance, visit support.torproject.org/#connectingtotor which is the FAQ page. I don't know how or why it was decided to show which URL where, but I do believe that whatever we do, we need to be consistent.

comment:3 Changed 7 weeks ago by pili

Cc: phw ggus antonela pili added
Sponsor: Sponsor30-can

We should discuss this one...

comment:4 Changed 7 weeks ago by ggus

I like this idea.

And users from censored networks probably can't access our documentation because Tor Project main domain would be blocked too and I don't know if we have mirrors for tb-manual and support.tpo.

So this offline page could have:

comment:5 Changed 7 weeks ago by gk

Years ago we had lengthy discussions about shipping an offline TB manual that got ultimately stalled and never done. We might want to learn from this failure while working on #11698. Maybe this ticket is a duplicate of #20639, too?

comment:6 in reply to:  5 ; Changed 7 weeks ago by antonela

Replying to gk:

Maybe this ticket is a duplicate of #20639, too?

Since we are using Lektor for TB Manual, all the content is available in a markdown format. We could find a way to render an offline Lektor and ship it with Tor Browser, or we might want to pick the relevant content for censored users to config Tor Browser successfully and render a local HTML page. Either of those are worth for S30.

comment:7 in reply to:  6 ; Changed 7 weeks ago by ggus

Replying to antonela:

Replying to gk:

Maybe this ticket is a duplicate of #20639, too?

Since we are using Lektor for TB Manual, all the content is available in a markdown format. We could find a way to render an offline Lektor and ship it with Tor Browser, or we might want to pick the relevant content for censored users to config Tor Browser successfully and render a local HTML page. Either of those are worth for S30.

Lektor can generate static HTML for us :)

comment:8 in reply to:  7 Changed 7 weeks ago by boklm

Replying to ggus:

Replying to antonela:

Replying to gk:

Maybe this ticket is a duplicate of #20639, too?

Since we are using Lektor for TB Manual, all the content is available in a markdown format. We could find a way to render an offline Lektor and ship it with Tor Browser, or we might want to pick the relevant content for censored users to config Tor Browser successfully and render a local HTML page. Either of those are worth for S30.

Lektor can generate static HTML for us :)

Can it generate pdf? Maybe having to open a separate browser to look at the manual can be confusing.

comment:9 Changed 7 weeks ago by phw

I'm a fan of this, thanks mrphs! This is a good reminder that we will have to overhaul our circumvention-related documentation a bit because it's outdated.

Note: See TracTickets for help on using tickets.