added documentation files and pictures

see commit message for more details