major update to the docs

add lots of images