DRILL-2579: 2-Hygiene: Renamed to match semantics; fixed, added, formatted doc.; basic whitespace.
- Renamed createConnection -> getConnection.
- Renamed close -> closeConnections
- Added documentation fixes, clarifications, formatting.
- Fixed some basic whitespace.