added some diagrams and filled in most placeholders
intial submission for review