update diagrams
edits; add diagrams and supporting text to index page