Improving the docs

Trying to improve some of the documentation, and add examples on how to use the classes.  Box for now, motivated by the confusion on IRC.