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@python components: Documentation messages: 226456 nosy: docs@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 http://bugs.python.org/issue22344 _______________________________________