clean-up and add docs stub

the reason it's one big chunk is that i changed indentation to match zack's style, sorry!