[tor-bugs] #5811 [Tor Support]: Translate the TSUM into human and improve section organization

[Tor Bug Tracker & Wiki]

#5811: Translate the TSUM into human and improve section organization
-------------------------+--------------------------------------------------
 Reporter:  mikeperry    |          Owner:  runa                    
     Type:  defect       |         Status:  new                     
 Priority:  normal       |      Milestone:  Sponsor Z: March 1, 2013
Component:  Tor Support  |        Version:                          
 Keywords:               |         Parent:                          
   Points:               |   Actualpoints:                          
-------------------------+--------------------------------------------------
Changes (by runa):

 * cc: mikeperry (added)


Comment:

 Replying to [ticket:5811 mikeperry]:
 > I think it could benefit from a Table of Contents, and a few screenshots
 of what the TBB startup process looks like, and what the various failure
 modes look like (like blocking and bridge configuration). It probably
 should also include a brief description of the privacy properties you get
 from the Tor Browser (See #5294), and some hints on what the new Tor
 Browser branding actually looks like on your taskbar (so you don't use the
 wrong browser).

 I agree that the user manual could benefit from a lot of things, but I
 really really really want to keep it short. Our users will not bother
 reading it if it's too long. The idea is that the manual helps users get
 started with TBB, and they can then browse torproject.org and read more on
 their own. Maybe I should just throw in some helpful links at the bottom
 of the page instead?

 > Also, the GPG verification steps need to be improved to contain
 screenshots, moved to an "Advanced" section, or simply removed. How does
 one bootstrap trust in the downloaded GPG binary itself, anyway? Seems
 like useless noise to even mention GPG verification at that point.

 Are there any better options?

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