refs #14 (and improving docs)