documentation improvements and additions, including some new images for reference