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.
Could you add something like "... by Google engineer Rob Ewaschuk" for context for anyone who doesn't immediately click on the link?