remove long syntax from the user's guide
new doc page with long syntax
tutorial with short syntax of keywords, closes #272
Merge pull request #275 from vlukes/short_syntax