Add lots of docs, mostly best practices.

Start out on the visualisation docs.

Expand overview, remove federation as a feature we don't have that yet.

Switch example variable to follow naming scheme.
This looks similar to a run-on sentence (http://en.wikipedia.org/wiki/Run-on_sentence), although even as that, it's confusing to me grammatically. Please make one/two correct sentences out of it.