[docs] [issue22344] Reorganize unittest.mock docs into linear manner

[py.user]

New submission from py.user:

Now, it's very inconvenient to learn this documentation. It's not compact (could be reduced in 2 or even 3 times). It repeats itself: many examples copy-pasted unchangeably. And it cites to terms that placed under those cites, so people should start at the bottom to anderstand what it's talking about on the top.

Remember Zen "If the implementation is hard to explain, it's a bad idea."

- Move the MagicMock description to the point between Mock and PropertyMock descriptions
- Remove "copy-paste" examples
- Rename print to print() and StringIO to io
- Split the Autospecing section to several chunks

----------
assignee: docs at python
components: Documentation
messages: 226456
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: Reorganize unittest.mock docs into linear manner
type: enhancement
versions: Python 3.4

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