added examples to documentation
removed broken link to usage page
fixed example descriptions
added server definition for github pages