added connection / transaction docs

review by @szeiger