diff --git a/shortcuts.yml b/shortcuts.yml
index 1c171e6..8c3a04a 100644
--- a/shortcuts.yml
+++ b/shortcuts.yml
@@ -1,27 +1,11 @@
-# This is a YAML file, more abouts its syntax: https://en.wikipedia.org/wiki/YAML
+# Documentation:
+# https://github.com/trovu/trovu.github.io/wiki/Advanced-settings-%26-personal-shortcuts/_edit#personal-shortcuts
 
-# First example shortcut: Short notation.
-# Use 
-#
-#   KEYWORDNAME ARGCOUNT
-#
-# as the key, and the target URL as the value.
-# This shortcut will match for "examplekeyword" with no arguments.
 examplekeyword 0: http://www.example.com/
-
-# This shortcut will match for "examplekeyword foo", 
-# so for the same keyword but with one argument.
 examplekeyword 1: http://www.example.com/?q={%query} 
-
-# Another example: extended notation
-# This shortcut will match for "examplekeyword foo, bar", 
-# Here you can define optional title, description and tags.
 examplekeyword 2:
   url: http://www.example.com/?q={%query}&p={%puery}
   title: Custom shortcut
   description: My custom shortcut with the keyword examplekeyword and 2 arguments.
   tags:
   - example
-
-# Make sure that the keys are unique, 
-# e.g. that the every "KEYWORDNAME ARGCOUNT" is only used once in this file.