[tahoe-lafs-trac-stream] [tahoe-lafs] #1024: introductory docs are confusing and off-putting

tahoe-lafs trac at tahoe-lafs.org
Fri Aug 19 10:14:16 PDT 2011


#1024: introductory docs are confusing and off-putting
-------------------------+-------------------------------------------------
     Reporter:  zooko    |      Owner:  marlowe
         Type:  defect   |     Status:  new
     Priority:  major    |  Milestone:  soon
    Component:           |    Version:  1.6.1
  documentation          |   Keywords:  docs install packaging website
   Resolution:           |  tahoe-run review-needed
Launchpad Bug:           |
-------------------------+-------------------------------------------------

Comment (by zooko):

 I was just searching the internet for mention of Tahoe-LAFS and I found
 this discussion on a bulletin board where apparently this windows user was
 scared off by the fact that [source:trunk/docs/quickstart.rst?rev=5069
 quickstart.rst] appeared to be instructing them to ''type'' things into
 their computer!

 http://forum.i2p2.de/viewtopic.php?p=32165#32165

 I'm not sure what we can do about this, except possibly to add text to
 quickstart.rst reassuring Windows users that this is actually ''not'' a
 Linux-only thing even though it involes ''typing'' ''words'' and maybe
 even explaining, as the responder did on that forum, how to open
 {{{cmd.exe}}}.

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


More information about the tahoe-lafs-trac-stream mailing list