update the docs

docs/designers-developers/developers/block-api/block-registration.md

@@ -670,19 +670,21 @@ Blocks can be added to collections, grouping together all blocks from the same o
 
 This should match the namespace declared in the block name; the name of your plugin or theme.
 
-### Title
+### Settings
+
+#### Title
 
 * **Type:** `String`
 
 This will display in the block inserter section, which will list all blocks in this collection.
 
-### Icon
+#### Icon
 
 * **Type:** `Object`
 
 (Optional) An icon to display alongside the title in the block inserter.
 
 ```js
 // Registering a block collection
-registerBlockCollection( 'my-plugin', 'My Plugin' );
+registerBlockCollection( 'my-plugin', { title: 'My Plugin' } );
 ```

docs/designers-developers/developers/data/data-core-blocks.md

@@ -94,7 +94,7 @@ _Parameters_
 
 _Returns_
 
--   `Array`: Collections list.
+-   `Object`: Collections list.
 
 <a name="getDefaultBlockName" href="#getDefaultBlockName">#</a> **getDefaultBlockName**
 

packages/blocks/README.md

@@ -634,7 +634,7 @@ Registers a new block collection to group blocks in the same namespace in the in
 _Parameters_
 
 -   _namespace_ `string`: The namespace to group blocks by in the inserter; corresponds to the block namespace
--   _title_ `Object`: , icon    The title to show in the inserter, The icon to show in the inserter
+-   _settings_ `Object`: An object composed of a title to show in the inserter, and an icon to show in the inserter
 
 <a name="registerBlockStyle" href="#registerBlockStyle">#</a> **registerBlockStyle**
 

packages/blocks/src/api/registration.js

@@ -253,8 +253,8 @@ export function registerBlockType( name, settings ) {
 /**
  * Registers a new block collection to group blocks in the same namespace in the inserter.
  *
- * @param {string} namespace      The namespace to group blocks by in the inserter; corresponds to the block namespace
- * @param {Object} title, icon    The title to show in the inserter, The icon to show in the inserter
+ * @param {string} namespace The namespace to group blocks by in the inserter; corresponds to the block namespace
+ * @param {Object} settings  An object composed of a title to show in the inserter, and an icon to show in the inserter
  *
  */
 export function registerBlockCollection( namespace, { title, icon } ) {

packages/blocks/src/store/selectors.js

@@ -112,7 +112,7 @@ export function getCategories( state ) {
  *
  * @param {Object} state Data state.
  *
- * @return {Array} Collections list.
+ * @return {Object} Collections list.
  */
 export function getCollections( state ) {
 	return state.collections;