Improvements and additions to documentation incorporating latest changes