[or-cvs] r14286: A new section in the documentation page for people who want (website/trunk/en)

Thu Apr 3 08:53:35 UTC 2008

Author: arma
Date: 2008-04-03 04:53:34 -0400 (Thu, 03 Apr 2008)
New Revision: 14286

Modified:
   website/trunk/en/documentation.wml
Log:
A new section in the documentation page for people who want to learn
all about Tor's design but don't know what they should read.


Modified: website/trunk/en/documentation.wml
===================================================================

--- website/trunk/en/documentation.wml	2008-04-03 08:45:48 UTC (rev 14285)
+++ website/trunk/en/documentation.wml	2008-04-03 08:53:34 UTC (rev 14286)
@@ -78,6 +78,101 @@
 may be interesting for developers.</li>
 </ul>
 
+<a id="UpToSpeed"></a>
+<h2><a class="anchor" href="#UpToSpeed">Getting up to speed on Tor's past,
+present, and future</a></h2>
+
+<ol>
+<li>
+First, read the <a href="<page overview>">overview page</a> to get a
+basic idea of how Tor works, what it's for, and who uses it.
+</li>
+
+<li>
+<a href="<page download>">Install the Tor bundle</a> and try it out.
+Make sure you've got Firefox installed first, and be sure to read the
+<a href="<page download>#Warning">list of warnings</a> about ways you
+can screw up your anonymity.
+</li>
+
+<li>
+Download and watch Roger's overview talk from What The Hack (<a
+href="http://freehaven.net/~arma/wth-anonymous-communication-58.mp4">video</a>,
+<a href="http://freehaven.net/~arma/wth1.pdf">slides</a>, <a
+href="http://wiki.whatthehack.org/index.php/Anonymous_communication_for_the_United_States_Department_of_Defense...and_you">abstract</a>).
+This talk was given in July 2005, back when we were funded by EFF and back
+when the network was quite small, but it still provides good background
+on how Tor works and what it's for.
+</li>
+
+<li>
+Our <a
+href="https://wiki.torproject.org/noreply/TheOnionRouter/TorFAQ">FAQ</a>
+covers all sorts of topics, including questions about setting up a client
+or relay, concerns about anonymity attacks, why we didn't build Tor in
+other ways, and discussion of Tor users and abuse.
+</li>
+
+<li>
+<a href="https://blog.torproject.org/">Tor has a blog now</a>.
+We try to keep it updated every week or two with the latest news.
+</li>
+
+<li>
+Look through our <a href="#DesignDoc">Design
+Documents</a>. Notice that we have RFC-style specs to tell you exactly
+how Tor is built.
+</li>
+
+<li>
+There's a skeletal <a
+href="<svnsandbox>doc/design-paper/roadmap-future.pdf">list of items
+we'd like to tackle in the future</a>. Alas, many of those items need
+to be fleshed out more before they'll make sense to people who aren't
+Tor developers, but you can still get a general sense of what issues
+need to be resolved next.
+</li>
+
+<li>
+Download and watch Roger's "blocking-resistance
+and circumvention" talk from 23C3 in December 2006 (<a
+href="http://freehaven.net/~arma/23C3-1444-en-tor_and_china.m4v">video</a>,
+<a href="http://freehaven.net/~arma/slides-23c3.pdf">slides</a>,
+<a href="http://events.ccc.de/congress/2006/Fahrplan/events/1444.en.html">abstract</a>,
+<a href="<svnsandbox>doc/design-paper/blocking.html">design paper</a>),
+or Roger's "Current events in Tor development" talk from 24C3 in December
+2007 (<a
+href="http://freehaven.net/~arma/24c3-2325-en-current_events_in_tor_development.mp4">video</a>,
+<a href="http://freehaven.net/~arma/slides-24c3.pdf">slides</a>,
+<a href="http://events.ccc.de/congress/2007/Fahrplan/events/2325.en.html">abstract</a>).
+We also have the What The Hack tutorial on hidden services (<a
+href="http://freehaven.net/~arma/wth_tor_hidden_services.mp4">video</a>,
+<a href="http://freehaven.net/~arma/wth3.pdf">slides</a>).
+</li>
+
+<li>
+Learn about the <a
+href="<svnsandbox>doc/spec/proposals/001-process.txt">Tor
+proposal process for changing our design</a>, and look over the <a
+href="<svnsandbox>doc/spec/proposals/">existing proposals</a>.
+</li>
+
+<li>
+Our <a href="<svnsandbox>doc/TODO">developer TODO file</a> starts with a
+timeline for external promises &mdash; things <a href="<page sponsors>">our
+sponsors</a> have paid to see done. It also lists many other tasks
+and topics we'd like to tackle next.
+</li>
+
+<li>
+Once you're up to speed, things will continue to change surprisingly fast.
+The <a href="#MailingLists">or-dev mailing list</a> is where the complex
+discussion happens, and the <a href="#Support">#tor IRC channel</a>
+is where the less complex discussion happens.
+</li>
+
+</ol>
+
 <a id="DesignDoc"></a>
 <h2><a class="anchor" href="#DesignDoc">Design Documents</a></h2>
 <ul>
@@ -99,12 +194,7 @@
 <b>design of a blocking-resistant anonymity system</b>:
 <a href="<svnsandbox>doc/design-paper/blocking.pdf">PDF draft</a> and
 <a href="<svnsandbox>doc/design-paper/blocking.html">HTML draft</a>.
-You can also see <a
-href="http://freehaven.net/~arma/slides-23c3.pdf">slides</a> and <a
-href="http://freehaven.net/~arma/23C3-1444-en-tor_and_china.m4v">video</a>
-from Roger's <a href="http://events.ccc.de/congress/2006/Home">23C3
-talk</a>. Want to <a href="<page volunteer>#Coding">help us build
-it</a>?</li>
+Want to <a href="<page volunteer>#Coding">help us build it</a>?</li>
 <li>The <b>specifications</b> aim to give
 developers enough information to build a compatible version of Tor:
 <ul>
@@ -129,14 +219,7 @@
 <li><a href="<svnsandbox>doc/spec/proposals/">In-progress drafts of
 new specifications and proposed changes</a></li>
 </ul></li>
-<li>Look at the <a href="http://freehaven.net/~arma/wth1.pdf">slides
-(PDF)</a> and <a
-href="http://rehash.waag.org/WTH/wth-anonymous-communication-58.mp4.torrent">video
-(torrent)</a> from the Tor talk Roger gave at <a
-href="http://whatthehack.org/">What the Hack (WTH)</a>. We also have <a
-href="http://freehaven.net/~arma/wth3.pdf">slides</a> and <a
-href="http://rehash.waag.org/WTH/wth_tor_hidden_services.mp4.torrent">video</a>
-of the WTH talk on hidden services.</li>
+
 </ul>
 
 <a id="NeatLinks"></a>

