more visualization notes
added doc/notes (which used to be ignored)