[Python-Dev] cpython: PEP 417: Adding unittest.mock (original) (raw)

Michael Foord fuzzyman at voidspace.org.uk
Sun Mar 18 19:44:28 CET 2012

On 16 Mar 2012, at 11:54, Nick Coghlan wrote:

On Thu, Mar 15, 2012 at 6:27 AM, Michael Foord <fuzzyman at voidspace.org.uk> wrote:

On the topic of docs.... mock documentation is about eight pages long. My intention was to strip this down to just the api documentation, along with a link to the docs on my site for further examples and so on. I was encouraged here at the sprints to include the full documentation instead (minus the mock library comparison page and the front page can be cut down). So this is what I am now intending to include. It does mean the mock documentation will be "extensive". Don't forgot you also have the option of splitting out a separate HOWTO tutorial section, leaving the main docs as a pure API reference. (I personally find that style easier to use than the ones which try to address both needs in the main module docs).

The docs are already organised as API docs and then simple and advanced HOWTO style sections. There are minimal examples inline with the API docs and separate paragraphs of explanations below on particular topics. Feel free to critique the mock docs as they are, or wait until I have committed modified versions.

Michael

Cheers, Nick.

-- Nick Coghlan | ncoghlan at gmail.com | Brisbane, Australia

-- http://www.voidspace.org.uk/

May you do good and not evil May you find forgiveness for yourself and forgive others May you share freely, never taking more than you give. -- the sqlite blessing http://www.sqlite.org/different.html

More information about the Python-Dev mailing list