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

[tahoe-lafs]

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

Comment (by zooko):

 Agreed that attachment:update-doc-about.rst.darcs.patch​ was committed in
 [4a29642623196b4b9b965ecbd7697bb96e935c92/git] ≈ [20111206171908-92b7f-
 1c2623b8ac7dd9afb339a4f9f90d4b76088fbf1b/trunk].

 However, the ticket is far from fixed. The introductory docs are (I
 suspect) still confusing and off-putting to newcomers. The suggestions by
 Glyph, Serguei Osokine, Brian Warner, and others that have been noted in
 the comments on this ticket still deserve more work.

 Is there a way that we can break this ticket into smaller tickets or
 otherwise define a smaller unit of work on which we can make definite
 progress?

 How about: take the current introductory docs as they now exist, find an
 innocent, untainted user who has never tried to use Tahoe-LAFS before, and
 watch carefully while they try to figure it out, and take notes. That
 could be a separate ticket which someone could complete in a finite amount
 of work.

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