updated docs to reflect recent fixes and enhancements