commit e13ef5f34bc189ecd2d5c96afe3267d544225cee
Author: Harmony <harmon...@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 get...@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
+ h...@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)
_______________________________________________
tor-commits mailing list
tor-commits@lists.torproject.org
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits
