diff --git a/bin/update-readmes.js b/bin/update-readmes.js
index 98c831386475d..da84d066eef75 100755
--- a/bin/update-readmes.js
+++ b/bin/update-readmes.js
@@ -5,7 +5,7 @@ const childProcess = require( 'child_process' );
const packages = [
'a11y',
- //'autop',
+ 'autop',
'blob',
//'block-editor',
'block-library',
diff --git a/packages/autop/README.md b/packages/autop/README.md
index 4aecd9cafa3de..ffb9168b63f20 100644
--- a/packages/autop/README.md
+++ b/packages/autop/README.md
@@ -12,23 +12,61 @@ npm install @wordpress/autop --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)._
-### Usage
+### API
-Import the desired function(s) from `@wordpress/autop`:
+
+
+#### autop
+
+[src/index.js#L129-L285](src/index.js#L129-L285)
+
+Replaces double line-breaks with paragraph elements.
+
+A group of regex replaces used to identify text formatted with newlines and
+replace double line-breaks with HTML paragraph tags. The remaining line-
+breaks after conversion become `
` tags, unless br is set to 'false'.
+
+**Usage**
```js
-import { autop, removep } from '@wordpress/autop';
+import { autop } from '@wordpress/autop';
+autop( 'my text' ); // "
my text
" +``` + +**Parameters** + +- **text** `string`: The text which has to be formatted. +- **br** `boolean`: Optional. If set, will convert all remaining line- breaks after paragraphing. Default true. + +**Returns** + +`string`: Text which has been converted into paragraph tags. -autop( 'my text' ); -// "my text
" +#### removep -removep( 'my text
' ); -// "my text" +[src/index.js#L303-L426](src/index.js#L303-L426) + +Replaces `` tags with two line breaks. "Opposite" of autop(). + +Replaces `
` tags with two line breaks except where the `
` has attributes. +Unifies whitespace. Indents `
my text
' ); // "my text" ``` -### API Usage +**Parameters** + +- **html** `string`: The content from the editor. + +**Returns** + +`string`: The content with stripped paragraph tags. + -* `autop( text: string ): string` -* `removep( text: string ): string` +my text
" + * ``` + * * @return {string} Text which has been converted into paragraph tags. */ export function autop( text, br = true ) { @@ -284,6 +291,13 @@ export function autop( text, br = true ) { * Unifies whitespace. Indents `my text
' ); // "my text" + * ``` + * * @return {string} The content with stripped paragraph tags. */ export function removep( html ) {