Integrate fixes to debugging and optimization topics from ChrisM and Alon
Add test suite doc and update everywhere to link to this. Update developers guide and associated docs
Fix a few broken links
Merge pull request #2804 from hamishwillee/incoming

Fixes to debugging, optimization, developers guide.