[tor-commits] [user-manual/master] Add section on downloading, and TODO file

harmony at torproject.org harmony at torproject.org
Thu Jun 25 11:32:24 UTC 2015


commit e13ef5f34bc189ecd2d5c96afe3267d544225cee
Author: Harmony <harmony01 at riseup.net>
Date:   Thu Jun 25 11:29:51 2015 +0000

    Add section on downloading, and TODO file
---
 C/downloading.page |  131 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 TODO               |   55 ++++++++++++++++++++++
 2 files changed, 186 insertions(+)

diff --git a/C/downloading.page b/C/downloading.page
new file mode 100644
index 0000000..31b5b7f
--- /dev/null
+++ b/C/downloading.page
@@ -0,0 +1,131 @@
+<page xmlns="http://projectmallard.org/1.0/"
+  type="topic"
+  id="downloading">
+
+<info>
+  <desc>How to download Tor Browser</desc>
+  <link type="guide" xref="index" />
+</info>
+
+<title>Downloading</title>
+
+<p>
+The safest and simplest way to download Tor Browser is from the official
+Tor Project website at https://www.torproject.org. Your connection to
+the site will be secured using
+<link xref='secure-connections'>HTTPS</link>, so you can be sure that no
+one is tampering with your copy of the software while you download it.
+</p>
+
+<p>
+However, there may be times when you cannot access the Tor Project
+website: for example, it could be blocked on your network. If this
+happens, you can use one of the alternative download methods listed
+below.
+</p>
+
+<section id="satori">
+<title>Satori</title>
+ <p>
+ Satori is an add-on for the Chrome or Chromium browsers that allows you
+ to download several security and privacy programs from different
+ sources.
+ </p>
+ <p>
+ To download Tor Browser using Satori:
+ </p>
+ <steps>
+  <item>
+  <p>
+  Install Satori from the Chrome App Store.
+  </p>
+  </item>
+  <item>
+  <p>
+  Select Satori from your browser’s Apps menu.
+  </p>
+  </item>
+  <item>
+  <p>
+  When Satori opens, click on your preferred language. A menu will open
+  listing the available downloads for that language. Find the entry for
+  Tor Browser under the name of your operating system. Select
+  either “A” or “B” after the name of the program — each one represents
+  a different source from which to get the software. Your download will
+  then begin.
+  </p>
+  </item>
+  <item>
+  <p>
+  Wait for your download to finish, then find the “Generate Hash”
+  section in Satori’s menu and click “Select Files”.
+  </p>
+  </item>
+  <item>
+  <p>
+  Select the downloaded Tor Browser file. Satori will display the
+  checksum of the file, which you should compare with the software’s
+  original checksum: you can find this by clicking the word “checksum”
+  after the link you clicked on to start the download. If the checksums
+  match, your download was successful, and you can
+  <link xref='first-time'>begin using Tor Browser</link>. If they do not
+  match, you may need to try downloading again, or from a different
+  source.
+  </p>
+  </item>
+ </steps>
+</section>
+
+<section id="gettor">
+<title>GetTor</title>
+ <p>
+ GetTor is an email-based service that automatically responds to
+ messages with links to the latest version of Tor Browser, hosted at a
+ variety of locations, such as Dropbox.
+ </p>
+ 
+ <p>
+ To use GetTor:
+ </p>
+ <steps>
+  <item>
+  <p>
+  Send an email to gettor at torproject.org, and in the body
+  of the message simply write “windows”, “osx”, or “linux”, (without
+  quotation marks) depending on your operating system.
+  </p>
+  </item>
+  <item>
+  <p>
+  GetTor will respond with an email containing links from which you can
+  download the Tor Browser package, the cryptographic signature (needed
+  for verifying the download), the fingerprint of the key used to make
+  the signature, and the package’s checksum. You may be offered a choice
+  of “32-bit” or “64-bit” software: this depends on the model of the
+  computer you are using.
+  </p>
+  </item>
+ </steps>
+</section>
+
+<section id="website-mirror">
+<title>Tor website mirrors</title>
+ <p>
+ A number of volunteers around the world host “mirrors” of the Tor
+ Project website. These are identical copies of all the content and
+ software on the main website, hosted at different IP addresses and
+ URLs. The Tor Project periodically checks mirrored versions of the
+ software to make sure they are the same as the originals.
+ </p>
+ 
+ <p>
+ If the main Tor website is blocked for you, and the automated
+ distribution methods above do not work, send an email to
+ help at rt.torproject.org asking for some website mirror addresses. You
+ should then be able to download Tor Browser as normal from these sites.
+ Please note that you should take extra care to verify the software you
+ download from a mirror, to ensure that it has not been tampered with.
+ </p>
+</section>
+
+</page>
diff --git a/TODO b/TODO
new file mode 100644
index 0000000..7b45e95
--- /dev/null
+++ b/TODO
@@ -0,0 +1,55 @@
+==========
+SHORT TERM
+==========
+
+ADDITIONAL SCREENSHOTS
+
+Produce screenshots illustrating the download methods in the “How to
+download” section (Satori, GetTor, mirrors).
+
+SECTIONS TO ADD/EXPAND/MODIFY
+
+Add a section that explains how to verify the Tor Browser download in
+clear and simple steps.
+
+Expand “Using for the first time” section with guidance on
+extracting/“installing” Tor Browser, and locating it in the filesystem
+on each OS. Cover the need to move TB to OSX Applications folder (and
+not run from disk image). Take into account the change in Mac OSX
+installation once a developer cert is available (ETA: August 2015)
+
+Modify “Bridges” page if/when we have a domain-fronted API to
+autodiscover fresh bridges (ETA: December 2015)
+
+[XXX Add more here XXX]
+
+===========
+MEDIUM TERM
+===========
+
+LOCALIZATION
+
+Plan for the localization of the manual’s text into the set of languages
+for which Tor Browser is currently built; this could be done through
+crowdsourced translation (on Transifex) or by individual translators.
+
+DISTRIBUTION
+
+Work out distribution strategies for the manual. An online copy will be
+available, and could be promoted through Tor’s outreach channels and
+linked to from the website. GetTor could provide links to the manual
+or to a downloadable file. A file could be included in the Tor Browser
+download (see discussion on #11698).
+
+MAINTAINABILITY
+
+Develop a clear plan for updating the manual text as Tor Browser
+evolves. This will involve incorporating user
+feedback/frequently-encountered issues from the help desk assistants,
+and making sure that information about major user interface changes is
+obtained from the Tor Browser team in good time.
+
+OTHER SOFTWARE PRODUCTS
+
+Continue discussion with other software development teams who might
+require user documentation for their products (e.g. Tor Messenger)



More information about the tor-commits mailing list