Nick Mathewson bc6769e0d4 Merge remote-tracking branch 'catalyst-oniongit/bug23739' 7 éve
..
CodingStandards.md cbea334d6b Mention even more about changes files in doc/HACKING 7 éve
CodingStandardsRust.md 1645c5503d docs: Add notes on behaviours which Rust considers undefined. 7 éve
Fuzzing.md 4d3310932a Small fixes to fuzzing documentation. 7 éve
GettingStarted.md 8d913cc352 doc: make introduction paragraph point to correct data 7 éve
GettingStartedRust.md 40f1287978 doc: Add a good resource for learning to write Rust FFI. 7 éve
HelpfulTools.md 6a2a49e661 Improve docs on using gcov 7 éve
HowToReview.md cbea334d6b Mention even more about changes files in doc/HACKING 7 éve
README.1st.md 617e0f8d26 added some markdown formatting 9 éve
ReleasingTor.md 3c9ff0af96 small tweaks to releasingtor.md 7 éve
Tracing.md 6bf82a4910 More clarification on 13802 7 éve
WritingTests.md 6a2a49e661 Improve docs on using gcov 7 éve

README.1st.md

In this directory

This directory has helpful information about what you need to know to hack on Tor!

First, read GettingStarted.md to learn how to get a start in Tor development.

If you've decided to write a patch, CodingStandards.txt will give you a bunch of information about how we structure our code.

It's important to get code right! Reading WritingTests.md will tell you how to write and run tests in the Tor codebase.

There are a bunch of other programs we use to help maintain and develop the codebase: HelpfulTools.md can tell you how to use them with Tor.

If it's your job to put out Tor releases, see ReleasingTor.md so that you don't miss any steps!


For full information on how Tor is supposed to work, look at the files in https://gitweb.torproject.org/torspec.git/tree.

For an explanation of how to change Tor's design to work differently, look at https://gitweb.torproject.org/torspec.git/blob_plain/HEAD:/proposals/001-process.txt.

For the latest version of the code, get a copy of git, and

git clone https://git.torproject.org/git/tor

We talk about Tor on the tor-talk mailing list. Design proposals and discussion belong on the tor-dev mailing list. We hang around on irc.oftc.net, with general discussion happening on #tor and development happening on #tor-dev.

The other files in this HACKING directory may also be useful as you get started working with Tor.

Happy hacking!


XXXXX also describe

doc/HACKING/WritingTests.md

torguts.git

torspec.git

The design paper

freehaven.net/anonbib

XXXX describe these and add links.