docs(testing): add better instructions for contributors

Also moves the `-W` flag to global opts in the docs/ Makefile.

Closes #1721, #2230.
We should add a period here