minor documentation updates for #12

This should be ready for a 3.4.0 release now.