documentation: add links to clarify API

[peterjgrainger]

Purpose (TL;DR) - mandatory

Fix issue #2070 by adding links to Stubs and Spies documentation and clarifying how Fakes are linked to Stubs and Spies

How to verify

1. Check out this branch
2. Open the markdown file

Checklist for author

• npm run lint passes
• References to standard library functions are cached.

[mroderick]

Thank you for your pull request. There are a few inaccuracies, I've made some suggested changes that should be easy to import.

[peterjgrainger]

Thanks for the review @mroderick. On second look I think you are right. The methods have the same API as with stubs but it's confusing to add that info here.

Agree with your suggestions

[mroderick]

Perfect 👍

[mroderick]

Because of how the documentation works in this project, the changes won't be visible on the site until the next release (which won't be that long).