Improve developer docs with regards to writing Fakes

[pleshakov]

Had a developer struggling with how we use the Counterfeiter golang fake tool in our code. We should improve our developer docs to explain how to use the tool for development.

[bjee19]

Just leaving a note, I'm interested in picking this up.

[github-actions]

This issue is stale because it has been open 14 days with no activity. Remove stale label or comment or this will be closed in 14 days.