Opened 5 years ago

Closed 5 years ago

#14449 closed enhancement (fixed)

Bad Mac OS X Instructions

Reported by: cypherpunks Owned by: Sebastian
Priority: Very Low Milestone:
Component: Webpages/Website Version:
Severity: Keywords:
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description

The documentation on the Tor Project's website contains a few errors for Mac OS X users.

The syntax instructions on the “Verifying Signatures” page are wrong. “gpg --verify /Users/Alice/TorBrowser-4.0.3-osx-i386-en-US.dmg{.asc*,}” The signature file should come *before* the file one is trying to verify. ---> "gpg --verify /Users/Alice/Downloads/TorBrowser-4.0.3-osx32_en-US.dmg.asc /Users/Alice/Downloads/TorBrowser-4.0.3-osx32_en-US.dmg". That's pretty straight forward.

On the download page for the TBB, the instructions can be confusing for people not used to downloading applications not found on the App Store: “Download the file above, save it somewhere, then click on it, add the .dmg file inside your Applications folder and you will have a Tor Browser application in your chosen language that you can pin on your Dock.” Besides the fact that it should say "add the .dmg file TO your Applications folder," you don’t add the actual .dmg file. The user should mount the .dmg file, and then drag the actual TorBrowser application into her Applications folder. Otherwise she may think she has to mount the .dmg file every time from her Applications folder and then click the TBB, instead of just being able to launch the TBB from her Applications folder which I'm pretty sure is the intent here.

These sound like minute problems, but they pose a serious barrier to non-technical users who want to use Tor. It took a lot of external research for me on the web to figure out what I was doing wrong when I first started learning about this stuff. We need a diverse base of Tor users in order for the anonymity aspect to be effective. Let's fix this.

Child Tickets

Attachments (2)

Screen Shot 2015-01-28 at 10.51.14 AM.png (431.9 KB) - added by cypherpunks 5 years ago.
Verifying Signatures Error
Screen Shot 2015-01-28 at 10.51.45 AM.png (311.7 KB) - added by cypherpunks 5 years ago.
Mac OS X Installation Instruction Error

Download all attachments as: .zip

Change History (3)

Changed 5 years ago by cypherpunks

Verifying Signatures Error

Changed 5 years ago by cypherpunks

Mac OS X Installation Instruction Error

comment:1 Changed 5 years ago by Sebastian

Resolution: fixed
Status: newclosed

The former is actually correct. Your shell expands "bla{foo,bar}" to "blafoo blabar". The star is there because sometimes the browser adds a .txt extension. I reworded the latter, thanks!

Note: See TracTickets for help on using tickets.