3.0 standards around doc blocks

PR as discussed in https://github.com/cakephp/cakephp/issues/3307