[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

Re: [tor-bugs] #11652 [Tor bundles/installation]: Review text of Short User Manual



#11652: Review text of Short User Manual
-------------------------------------+-------------------------------------
     Reporter:  mttp                 |      Owner:
         Type:  task                 |     Status:  new
     Priority:  normal               |  Milestone:
    Component:  Tor                  |    Version:
  bundles/installation               |   Keywords:  tbum, manual,
   Resolution:                       |  documentation
Actual Points:                       |  Parent ID:
       Points:                       |
-------------------------------------+-------------------------------------
Description changed by mttp:

Old description:

> I've written up some new information that I propose be used in the Tor
> Browser User Manual. I think this ticket is a good place for review,
> critique, syntax changes, organizational suggestions, etc.
>
> index:
>
> = Tor Browser Help =
> [xref:how-tor-works TorHow Tor works.][xref:troubleshooting
> TroubleshootingWhat to do if Tor Browser doesn't
> work.][xref:circumvention CircumventionWhat to do if the Tor network is
> blocked.][xref:bridges BridgesWhat bridges are and how to use
> them.][xref:uninstalling UninstallingHow to remove Tor Browser from your
> system.]troubleshooting:
>
> = Troubleshooting =
> The Tor Browser should get you online automatically after clicking the
> "Connect" button on the start up screen.
>
> <screenshot of connect button>
>
> If it doesn't connect, there may be a simple fix. Try each of the
> following:
>
>  * Make sure another Tor Browser is not already running. If you're not
> sure if Tor Browser is running, restart your computer.
>

>  * 'Allow' Tor in your antivirus program.
>

>  * Temporarily disable your firewall.
>

>  * Delete Tor Browser and install it again. If updating, do not overwrite
> your previous Tor Browser files.
>

>
> If you still can't connect, your internet service provider might be
> censoring connections to Tor. Follow the instructions in the
> [xref:circumvention Circumvention]Âsection.
>
> If the above steps do not address your problem, email
> help@xxxxxxxxxxxxxxxxx with your operating system, the details of your
> problem, and what you've already tried.
>
> circumvention:
>
> = Circumvention =
> Some firewalls can detect and block connections to Tor. The Tor Browser
> includes some circumvention tools for getting around blocking firewalls.
> These circumvention tools are called Pluggable Transports. To turn them
> on, click "Configure" in the Tor launcher window.
>
> <screenshot of configure button>
>
> Select yes when asked if your internet service provider blocks
> connections to Tor."
>
> <screenshot of tor-launcher wizard>
>
> Select "Connect with provided bridges". Tor Browser has three Pluggable
> Transports to choose from. If one fails to get you online, try selecting
> a different transport.
>
> <screenshot of transport drop-down menu>
>
> If you try all three transports, and none of them get you online, select
> "Enter custom bridges", and enter bridges manually. Read the
> [xref:bridges Getting Bridges] section for instructions on getting custom
> bridges.
>
> bridges:
>
> = Bridges =
> Bridges are quiet gateways into the Tor Network. Like Tor relays, they
> are run by volunteers. Unlike relays, they are not listed publicly. Using
> bridges disguise the fact that one is using Tor.
>
> Currently there are five bridge types, or transports, available. More are
> being developed.
>
> || ORPort || Requesting 'bridges' without specifying the bridge type,
> will return ORPort bridges, also called Vanilla bridges. ORPort bridges
> are NOT reliable for circumventing censorship or national firewalls.
> ORPort bridges can be useful as trusted entry points into the Tor
> network. ||
> || obfs2 || Censors have learned how to identify obfs2 bridges. This
> transport is being deprecated. ||
> || obfs3 || Obfsproxy disguises Tor traffic as random noise. obfs3
> bridges work almost everywhere. A few obfs3 bridges have been blocked. ||
> || Scramblesuit || Scramblesuit is an additional tool for the obfsproxy
> transport. Scramblesuit bridges are designed to be hard to identify and
> hard to block. ||
> || FTE || Format-Transforming Encryption disguises Tor traffic as web
> (HTTP) traffic or other types of internet traffic. FTE bridges are
> effective, but in limited supply. ||
>
> (Note that flashproxy is a Pluggable Transport, but does not rely on
> bridges.)
>
> There are four ways to get a bridge.
>
>  1. VisitÂhttps://bridges.torproject.org/Âand follow the instructions.
>

>  1. Email bridges@xxxxxxxxxxxxxxxxxxxxxx from a gmail or yahoo email
> address. PutÂget bridgesÂin the body for ORPort bridges or
> transport=obfs3for obfs3 bridges.
>

>  1. Politely ask a human at help@xxxxxxxxxxxxxxxxx if you cannot access
> either of the first two methods.
>

>  1. Install and configure a Tor instance to be bridge for yourself. The
> computer acting as a bridge must have uncensored internet access to the
> Tor network. A full installation guide can be found
> at[https://www.torproject.org/projects/obfsproxy-debian-
> instructions.html.en https://www.torproject.org/projects/obfsproxy-
> debian-instructions.html.en]
>

>
> Enter the bridge information you get from any of the above steps in Tor-
> launcher.
>
> Choose yes when asked if your Internet Service Provider blocks
> connections to the Tor network. Select 'Use custom bridges' and enter
> each bridge identifier on its own line.
>
> <screenshot of custom bridge entry>
>
> Click Connect. Using bridges slow down the connection. If the connection
> fails, the bridges you received may be down. Get more and try again.
>
> uninstalling:
>
> = Uninstalling =
> The Tor Browser does not affect any of the existing software or settings
> on your computer. Uninstalling Tor Browser will not affect your system's
> software or settings either.
>
> Removing the Tor Browser from your system is simple:
>
>  1. Locate your Tor Browser folder. The default location is your Desktop.
>

>  1. Delete the Tor Browser folder.
>

>  1. Empty your Trash
>

>
> Note that your operating system's standard "Uninstall" utility is not
> used.

New description:

 I've written up some new information that I propose be used in the Tor
 Browser User Manual. I think this ticket is a good place for review,
 critique, syntax changes, organizational suggestions, etc.

 index:

 = Tor Browser Help =
 [xref:how-tor-works TorHow Tor works.][xref:troubleshooting
 TroubleshootingWhat to do if Tor Browser doesn't work.][xref:circumvention
 CircumventionWhat to do if the Tor network is blocked.][xref:bridges
 BridgesWhat bridges are and how to use them.][xref:uninstalling
 UninstallingHow to remove Tor Browser from your system.]= Troubleshooting
 =
 The Tor Browser should get you online automatically after clicking the
 "Connect" button on the start up screen.

 <screenshot of connect button>

 If it doesn't connect, there may be a simple fix. Try each of the
 following:

  * Make sure another Tor Browser is not already running. If you're not
 sure if Tor Browser is running, restart your computer.

  * 'Allow' Tor in your antivirus program.

  * Temporarily disable your firewall.

  * Delete Tor Browser and install it again. If updating, do not overwrite
 your previous Tor Browser files.

 If you still can't connect, your internet service provider might be
 censoring connections to Tor. Follow the instructions in the
 [xref:circumvention Circumvention] section.

 If the above steps do not address your problem, email
 help@xxxxxxxxxxxxxxxxx with your operating system, the details of your
 problem, and what you've already tried.

 circumvention:

 = Circumvention =
 Some firewalls can detect and block connections to Tor. The Tor Browser
 includes some circumvention tools for getting around blocking firewalls.
 These circumvention tools are called Pluggable Transports. To turn them
 on, click "Configure" in the Tor launcher window.

 <screenshot of configure button>

 Select yes when asked if your internet service provider blocks connections
 to Tor."

 <screenshot of tor-launcher wizard>

 Select "Connect with provided bridges". Tor Browser has three Pluggable
 Transports to choose from. If one fails to get you online, try selecting a
 different transport.

 <screenshot of transport drop-down menu>

 If you try all three transports, and none of them get you online, select
 "Enter custom bridges", and enter bridges manually. Read the [xref:bridges
 Getting Bridges] section for instructions on getting custom bridges.

 bridges:

 = Bridges =
 Bridges are quiet gateways into the Tor Network. Like Tor relays, they are
 run by volunteers. Unlike relays, they are not listed publicly. Using
 bridges disguise the fact that one is using Tor.

 Currently there are five bridge types, or transports, available. More are
 being developed.

 || ORPort || Requesting 'bridges' without specifying the bridge type, will
 return ORPort bridges, also called Vanilla bridges. ORPort bridges are NOT
 reliable for circumventing censorship or national firewalls. ORPort
 bridges can be useful as trusted entry points into the Tor network. ||
 || obfs2 || Censors have learned how to identify obfs2 bridges. This
 transport is being deprecated. ||
 || obfs3 || Obfsproxy disguises Tor traffic as random noise. obfs3 bridges
 work almost everywhere. A few obfs3 bridges have been blocked. ||
 || Scramblesuit || Scramblesuit is an additional tool for the obfsproxy
 transport. Scramblesuit bridges are designed to be hard to identify and
 hard to block. ||
 || FTE || Format-Transforming Encryption disguises Tor traffic as web
 (HTTP) traffic or other types of internet traffic. FTE bridges are
 effective, but in limited supply. ||

 (Note that flashproxy is a Pluggable Transport, but does not rely on
 bridges.)

 There are four ways to get a bridge.

  1. Visit https://bridges.torproject.org/ and follow the instructions.

  1. Email bridges@xxxxxxxxxxxxxxxxxxxxxx from a gmail or yahoo email
 address. Put get bridges in the body for ORPort bridges or
 transport=obfs3for obfs3 bridges.

  1. Politely ask a human at help@xxxxxxxxxxxxxxxxx if you cannot access
 either of the first two methods.

  1. Install and configure a Tor instance to be bridge for yourself. The
 computer acting as a bridge must have uncensored internet access to the
 Tor network. A full installation guide can be found
 at[https://www.torproject.org/projects/obfsproxy-debian-
 instructions.html.en https://www.torproject.org/projects/obfsproxy-debian-
 instructions.html.en]

 Enter the bridge information you get from any of the above steps in Tor-
 launcher.

 Choose yes when asked if your Internet Service Provider blocks connections
 to the Tor network. Select 'Use custom bridges' and enter each bridge
 identifier on its own line.

 <screenshot of custom bridge entry>

 Click Connect. Using bridges slow down the connection. If the connection
 fails, the bridges you received may be down. Get more and try again.

 uninstalling:

 = Uninstalling =
 The Tor Browser does not affect any of the existing software or settings
 on your computer. Uninstalling Tor Browser will not affect your system's
 software or settings either.

 Removing the Tor Browser from your system is simple:

  1. Locate your Tor Browser folder. The default location is your Desktop.

  1. Delete the Tor Browser folder.

  1. Empty your Trash

 Note that your operating system's standard "Uninstall" utility is not
 used.

--

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/11652#comment:2>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online
_______________________________________________
tor-bugs mailing list
tor-bugs@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-bugs