Doc'd with-connection and a bit about perf-tuning [IMMUTANT-327]