remove long syntax from the user's guide
new doc page with long syntax
tutorial with short syntax of keywords, closes #272