wiki:Doc

Version 34 (modified by zooko, at 2008-04-08T15:27:57Z) (diff)

--

Documentation

The Basics

  • install-details.html: a big, unformatted, ill-maintained collection of notes about install issues on various platforms; Hopefully this doc isn't needed for you because the short and sweet "install.html" Just Works. If you love a certain platform and you write a nice install document describing how you build Tahoe on that platform then we will be grateful and you will earn a place in the CREDITS file.

Presentations / Papers

  • The paper presented at PyCon2008, providing an overview of the Tahoe design, and the slides (.zip) that were used for the presentation.

Developer Docs

These docs are stored in the source tree, under revision control. You can browse them through the web site:

Developer Wiki Pages

  • UseCases: the ways in which Tahoe should be useful
  • Security: known security issues and workarounds
  • FileEncoding?, explaining how we turn files into shares, with verifiable hashes; This is mostly concerned with chunking and Merkle trees.
  • ShareEncoding?, explaining how we turn a chunk into shares: Reed-Solomon, FEC, that stuff
  • PeerSelection, explaining how a Tahoe node chooses which other nodes to use for uploading and downloading files (which raises some unsolved issues in balancing scalability, robustness, performance, and simplicity)
  • ChangingFilesWhileCopyingThem? : what are the semantics of the "upload" action? the upload takes non-zero time: what happens if the file is changed during that time?

The Parade of Release Notes

  • the release notes announcing v1.0 on March 25, 2008 -- It's version 1.0!
  • the release notes announcing v0.9 on March 13, 2008 -- Tahoe is now ready to be relied on for secure storage
  • the release notes announcing v0.8 on February 15, 2008, adding "visibility" into the system and more user interfaces
  • the release notes announcing v0.7 on January 8, 2008, featuring decentralized directories and mutable files, a FUSE interface, and new open source licensing options
  • the release notes announcing v0.6.1 on October 15, 2007, including packaging, usability, and performance improvements
  • the release notes announcing v0.6 on September 24, 2007, including improved performance and packaging
  • the release notes announcing v0.5.1 on August 23, 2007, fixing a security problem in the Web API
  • the release notes announcing v0.5 on August 17, 2007, including the Web API and the command-line interface
  • the release notes announcing v0.4 on June 29, 2007, including the new mutable, shareable, private directories
  • the release notes announcing v0.3 on June 6, 2007, including improved basic functionality
  • the release notes announcing v0.2, the first public release, on May 2, 2007 and giving a general overview of why the Tahoe project exists

See Also