some enhancements on the documentation