[tahoe-lafs-trac-stream] [tahoe-lafs] #1477: reformatting and minor corrections to webapi.rst; remove a reference to the test grid

[tahoe-lafs]

#1477: reformatting and minor corrections to webapi.rst; remove a reference to the
test grid
-------------------------------+-------------------------
     Reporter:  davidsarah     |      Owner:  marlowe
         Type:  enhancement    |     Status:  new
     Priority:  minor          |  Milestone:  1.10.0
    Component:  documentation  |    Version:  1.8.2
   Resolution:                 |   Keywords:  docs webapi
Launchpad Bug:                 |
-------------------------------+-------------------------

Comment (by davidsarah):

 Could you also please apply this patch:
 {{{
 [[1.9.2 branch] Add comments and a caveat in webapi.rst indicating that
 the needs-rebalancing field may be computed incorrectly. refs #1115 refs
 #1784
 david-sarah at jacaranda.org**20120701230843
  Ignore-this: fd2939ae4291207978dc463a2ad92d1b
 ] {
 hunk ./docs/frontends/webapi.rst 1350
 -                            shares
 +                            shares. Note that a high value does not
 necessarily
 +                            imply good share distribution, because some
 of
 +                            these servers may only hold duplicate shares.
 hunk ./docs/frontends/webapi.rst 1367
 -    needs-rebalancing: (bool) True if there are multiple shares on a
 single
 -                       storage server, indicating a reduction in
 reliability
 -                       that could be resolved by moving shares to new
 -                       servers.
 +    needs-rebalancing: (bool) This field is intended to be True iff
 +                       reliability could be improved for this file by
 +                       rebalancing, i.e. by moving some shares to other
 +                       servers. It is not guaranteed to be computed
 correctly
 +                       in Tahoe-LAFS up to and including v1.9.2, and its
 +                       precise definition may change in future versions.
 hunk ./src/allmydata/immutable/checker.py 799
 +        # TODO: this may be wrong, see ticket #1115 comment:27 and
 ticket #1784.
 hunk ./src/allmydata/immutable/filenode.py 134
 +
 +                    # TODO: this may be wrong, see ticket #1115
 comment:27 and ticket #1784.
 }
 }}}
 Thanks.

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