Update docs

packages/html-entities/README.md

@@ -18,9 +18,24 @@ _This package assumes that your code will run in an **ES2015+** environment. If
 
 ### decodeEntities
 
-[src/index.js#L3-L22](src/index.js#L3-L22)
+[src/index.js#L16-L35](src/index.js#L16-L35)
 
-Undocumented declaration.
+Decodes the HTML entities from a given string.
+
+**Usage**
+
+```js
+const result = decodeEntities( 'á' );
+console.log( result ); // result will be "á"
+```
+
+**Parameters**
+
+-   **html** `string`: String that contain HTML entities.
+
+**Returns**
+
+`string`: The decoded string.
 
 
 <!-- END TOKEN(Autogenerated API docs) -->

packages/html-entities/src/index.js

@@ -1,5 +1,18 @@
 let _decodeTextArea;
 
+/**
+ * Decodes the HTML entities from a given string.
+ *
+ * @param {string} html String that contain HTML entities.
+ *
+ * @example
+ * ```js
+ * const result = decodeEntities( 'á' );
+ * console.log( result ); // result will be "á"
+ * ```
+ *
+ * @return {string} The decoded string.
+ */
 export function decodeEntities( html ) {
 	// not a string, or no entities to decode
 	if ( 'string' !== typeof html || -1 === html.indexOf( '&' ) ) {