clarify with examples
ws
improve example
update syntax, improve examples