Code doc improvements

I had to ask so I figured I'd update the documentation with the answer. I hope this reads okay.

This pull request is partly just to test that I'm using the process correctly while I find my feet.