Better docs

[noslouch]

More working examples will help people wrap their heads around the roles and responsibilities of connections and the service.

We should build out the dummy app with more examples and deploy that ad an app to a separate URL.