[tahoe-lafs-trac-stream] [tahoe-lafs] #776: users are confused by "tahoe rm"

[tahoe-lafs]

#776: users are confused by "tahoe rm"
-------------------------+-------------------------------------------------
     Reporter:  zooko    |      Owner:  davidsarah
         Type:  defect   |     Status:  assigned
     Priority:  major    |  Milestone:  1.10.0
    Component:  code-    |    Version:  1.4.1
  frontend-cli           |   Keywords:  docs usability tahoe-rm easy unlink
   Resolution:           |
Launchpad Bug:           |
-------------------------+-------------------------------------------------

Comment (by zooko):

 Okay here are all the ideas on this ticket for how to improve this. The
 ones we've already done are marked with ~~strikethru~~.
 * Make an animated 3D movie showing how to traverse and manipulate a
 Tahoe-LAFS filesystem (comment:3).
 * ~~Teach your children unix/capabilities/reference semantics in terms of
 a text-based dungeon crawling adventure (comment:5).~~
 * ~~Add a command named {{{tahoe unlink}}} and make it be the primary
 documented command (comment:13).~~
 * Have {{{tahoe rm}}} or {{{tahoe unlink}}} output a message such as "n
 directory entries removed ({{{tahoe unlink}}} does not delete files)."
 (comment:4).
 * Make {{{tahoe rm $CAP}}} or {{{tahoe unlink $CAP}}} emit a nice and
 explanatory error message instead of a mysterious stack trace. (comment:9)
 * Remove the {{{tahoe rm}}} command now that {{{tahoe unlink}}} has been
 the primary documented command for a couple of major releases
 (comment:13).

 The ones that we haven't done yet are still good ideas! Maybe we should
 open separate tickets for them since they are separately closeable and
 then people will be able to better remember to do them.

-- 
Ticket URL: <http://tahoe-lafs.org/trac/tahoe-lafs/ticket/776#comment:14>
tahoe-lafs <http://tahoe-lafs.org>
secure decentralized storage