some minor changes

language tags
intention of diagrams
typo in example