Some style fixes suggested by pep8-naming

Plus a bit more info in the developer docs about how to conform to our style requirements.

These are pulled from #683.