Weekend doc revisions

new figures and many doc updates