update notes, minor changes
improve diagram visbility