[docs] [issue17329] Document unittest.SkipTest

[Ezio Melotti]

Ezio Melotti added the comment:

> I wonder if that was meant to be TestCase.skipTest()?

Most likely.

I would document this exception at the end of the "Skipping tests and expected failures".  You could documented it simply as "the exception raised by the skip decorators", and suggest to use TestCase.skipTest() to skip a test rather than just raising this exception directly.

I'm also not sure if the note should be kept -- it seems quite obvious to me that the test will be marked as skipped even if previous assertions succeeded.  Moreover, if the exception is generally not supposed to be used directly there's no need to explain how to use it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue17329>
_______________________________________