Move the shortcode docs to documentation, add examples.
Merge pull request #1157 from mateusz/shortcode-docs

Move the shortcode docs to documentation, add examples.