[tahoe-dev] [tahoe-lafs] #757: there isn't a doc that says "which operations are efficient"

tahoe-lafs trac at allmydata.org
Tue Jul 14 18:30:22 PDT 2009


#757: there isn't a doc that says "which operations are efficient"
---------------------------+------------------------------------------------
 Reporter:  zooko          |           Owner:  somebody 
     Type:  enhancement    |          Status:  new      
 Priority:  major          |       Milestone:  undecided
Component:  documentation  |         Version:  1.4.1    
 Keywords:                 |   Launchpad_bug:           
---------------------------+------------------------------------------------

Comment(by warner):

 Also, include a copy of these notes in the source tree somewhere. Adding
 docs to the wiki is great and all, but I'd like people to be able to grab
 a source tree and know that they don't need to get anything else.

 The biggest benefits (in my mind) of having docs on the wiki is that 1)
 everybody can edit them, add questions, etc, and 2) you can reference them
 from other wiki pages with nice short !WikiNames. The benefit of having
 docs in the source tree are 1) long-term persistence, 2) no version skew
 between the tahoe version you're looking at and the docs, and 3) local
 availability despite allmydata.org and/or trac being down.

 Maybe each file in docs/ could have a corresponding wiki page, and the
 file could have a note at the bottom saying "for the latest version of
 this document, please see URL".
 And we could write a script that would fetch all the docs and copy them
 into the source tree.

-- 
Ticket URL: <http://allmydata.org/trac/tahoe/ticket/757#comment:2>
tahoe-lafs <http://allmydata.org>
secure decentralized file storage grid


More information about the tahoe-dev mailing list