[tahoe-lafs-trac-stream] [Tahoe-LAFS] #1439: add docs/tests.rst documenting how to run tests and how to interpret the output

[Tahoe-LAFS]

#1439: add docs/tests.rst documenting how to run tests and how to interpret the
output
-------------------------------+------------------------
     Reporter:  davidsarah     |      Owner:  somebody
         Type:  task           |     Status:  new
     Priority:  major          |  Milestone:  eventually
    Component:  documentation  |    Version:  1.8.2
   Resolution:                 |   Keywords:  docs test
Launchpad Bug:                 |
-------------------------------+------------------------

Old description:

> In ticket:145#comment:26, Zooko wrote about various ways to run the
> Tahoe-LAFS test suite, some of which work and some of which do not. He
> suggested adding a {{{docs/tests.rst}}} to document this.
>
> tests.rst should also document cases in which the tests are known to fail
> (such as when we're not testing the right code), how to interpret skips,
> todos, and other sources of noise, and how to get Twisted log output from
> test cases.

New description:

 In ticket:145#comment:26, Zooko wrote about various ways to run the Tahoe-
 LAFS test suite, some of which work and some of which do not. He suggested
 adding a {{{docs/tests.rst}}} to document this.

 tests.rst should also document cases in which the tests are known to fail
 (such as when we're not testing the right code), how to interpret skips,
 todos, and other sources of noise, and how to get Twisted log output from
 test cases.

--

Comment (by zooko):

 See also [//pipermail/tahoe-dev/2014-August/009152.html Nathan's comments
 about "How To Run Tests" during a Nuts & Bolts meeting].

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