Fix a few omissions and errors with the hash docs.

en/appendices/2-2-migration-guide.rst

@@ -54,8 +54,17 @@ Utility
 Set
 ---
 
+- The :php:class:`Set` class is now deprecated, and replaced by the :php:class:`Hash` class.
+  Set will not be removed until 3.0.
 - :php:meth:`Set::expand()` was added.
 
+Hash
+----
+
+The :php:class:`Hash` class was added in 2.2.  It replaced Set providing a more
+consistent, reliable and performant API to doing many of the same tasks Set
+does. See the :doc:`/core-utility-libraries/hash` page for more detail.
+
 Helpers
 =======
 

en/core-libraries.rst

@@ -109,11 +109,12 @@ logging, internationalization and more.
     core-libraries/logging
     core-utility-libraries/router
     core-utility-libraries/security
+    core-utility-libraries/hash
     core-utility-libraries/set
     core-utility-libraries/string
     core-utility-libraries/xml
 
 
 .. meta::
     :title lang=en: Core Libraries
-    :keywords lang=en: core libraries,global constants,cookie,access control lists,number,text,time,security component,core components,general purpose,web applications,markup,authentication,api,cakephp,functionality,sessions,collections,events
+    :keywords lang=en: core libraries,global constants,cookie,access control lists,number,text,time,security component,core components,general purpose,web applications,markup,authentication,api,cakephp,functionality,sessions,collections,events

en/core-utility-libraries/hash.rst

@@ -1,5 +1,5 @@
 Hash
-###
+####
 
 .. php:class:: Hash
 

en/core-utility-libraries/set.rst

@@ -12,7 +12,6 @@ CakePHP's Set class can be called from any model or controller in
 the same way Inflector is called. Example: :php:meth:`Set::combine()`.
 
 .. deprecated:: 2.2
-
     The Set class has been deprecated in 2.2 in favour of the :php:class:`Hash`
     class.  It offers a more consistent interface and API.