Tidy up io code reference, words and autodoc.

Should close #273
Add to level documentation to reference.

Should close #276
Merge pull request #508 from Cadair/0.3_docs

Documentation Improvements for 0.3