Flesh out the stubs and mocks documentation
Merge pull request #434 from richardmiller/add-to-stubs-docs

Flesh out the stubs and mocks documentation