documented stuff and move connections parameter