#713 cleanup can.Control, fixup contributing guide

#713 proposed solution. cleaned up can.Control docs to remove some noise and be more explicit in the main example. Also fixed up the contributing guide so it has working instructions for generating the docs, and renders command lines correctly.