document fixes and enhancements