update docs around connection manager deprecations

Refs https://github.com/cakephp/cakephp/pull/3923