diff --git a/bin/update-readmes.js b/bin/update-readmes.js
index b9a6dd6d2a92a..f15bedfdd0b64 100755
--- a/bin/update-readmes.js
+++ b/bin/update-readmes.js
@@ -32,7 +32,7 @@ const packages = [
'shortcode',
'url',
'viewport',
- //'wordcount',
+ 'wordcount',
];
const getArgsForPackage = ( packageName ) => {
diff --git a/packages/wordcount/README.md b/packages/wordcount/README.md
index 076a25ac81421..ecd1de4a1ed81 100644
--- a/packages/wordcount/README.md
+++ b/packages/wordcount/README.md
@@ -12,21 +12,34 @@ npm install @wordpress/wordcount --save
_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._
-## Accepted Parameters
+## API
-```JS
-count( text, type, userSettings )
-````
-count accepts three parameters:
-1. text: A string containing the words/characters to be counted.
-2. type: A string that represents the type of count. The current implementation accepts the strings 'words', 'characters_excluding_spaces', or 'characters_including_spaces'.
-3. userSettings: An object that contains the list of regular expressions that will be used to count. See defaultSettings.js for the defaults.
+
-## Usage
+### count
-```JS
+[src/index.js#L107-L121](src/index.js#L107-L121)
+
+Count some words.
+
+**Usage**
+
+```js
import { count } from '@wordpress/wordcount';
const numberOfWords = count( 'Words to count', 'words', {} )
```
+**Parameters**
+
+- **text** `String`: The text being processed
+- **type** `String`: The type of count. Accepts ;words', 'characters_excluding_spaces', or 'characters_including_spaces'.
+- **userSettings** `Object`: Custom settings object.
+
+**Returns**
+
+`Number`: The word or character count.
+
+
+
+