Update docs and tweak coding style.
Use explicit connection dependency instead of service locator, tweak phpdoc.