doc: add some comments to our connection examples.