Update docs based on review feedback on cakephp/docs#1530