[tahoe-lafs-trac-stream] [tahoe-lafs] #1761: Insufficient documentation about how to administer the convergence secret.

[tahoe-lafs]

#1761: Insufficient documentation about how to administer the convergence secret.
-----------------------------+---------------------------------------------
     Reporter:  nejucomo     |      Owner:  davidsarah
         Type:  defect       |     Status:  assigned
     Priority:  normal       |  Milestone:  1.10.0
    Component:               |    Version:  1.9.1
  documentation              |   Keywords:  docs convergence usability easy
   Resolution:               |
Launchpad Bug:               |
-----------------------------+---------------------------------------------
Changes (by davidsarah):

 * keywords:  docs convergence usability => docs convergence usability easy
 * status:  new => assigned
 * component:  unknown => documentation
 * milestone:  undecided => 1.10.0


Old description:

> A user in IRC just asked what the convergence secret was.  I explained
> its purpose, and they said they already knew that from reading the docs.
>
> What the did not know was "how to use it".  The docs should be very clear
> by saying something like:
>
> {{{
> To enable deduplication between different clients, securely copy
> the convergence secret file from one client to all the others.
>
> For example, if you are on host A and have an account on host B
> and you have scp installed, run:
>
>   scp ~/.tahoe/private/convergence
> my_other_account at B:.tahoe/private/convergence
> }}}

New description:

 A user in IRC just asked what the convergence secret was.  I explained its
 purpose, and they said they already knew that from reading the docs.

 What the did not know was "how to use it".  The docs should be very clear
 by saying something like:

 {{{
 To enable deduplication between different clients, securely copy
 the convergence secret file from one client to all the others.

 For example, if you are on host A and have an account on host B
 and you have scp installed, run:

   scp ~/.tahoe/private/convergence
 my_other_account at B:.tahoe/private/convergence
 }}}

--

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