some restructuring, added examples page, prettied up reference formatting