diff --git a/packages/react-is/README.md b/packages/react-is/README.md
index f744d7d1de..80c1490b2e 100644
--- a/packages/react-is/README.md
+++ b/packages/react-is/README.md
@@ -1,6 +1,6 @@
# `react-is`
-This package allows you to test arbitrary values and see if they're a particular React type, e.g. React Elements.
+This package allows you to test arbitrary values and see if they're a particular React element type.
## Installation
@@ -14,7 +14,37 @@ npm install react-is --save
## Usage
-### AsyncMode
+### Determining if a Component is Valid
+
+```js
+import * as ReactIs from "react-is";
+
+class ClassComponent extends React.Component {
+ render() {
+ return React.createElement("div");
+ }
+}
+
+const StatelessComponent = () => React.createElement("div");
+
+const ForwardRefComponent = React.forwardRef((props, ref) =>
+ React.createElement(Component, { forwardedRef: ref, ...props })
+);
+
+const Context = React.createContext(false);
+
+ReactIs.isValidElementType("div"); // true
+ReactIs.isValidElementType(ClassComponent); // true
+ReactIs.isValidElementType(StatelessComponent); // true
+ReactIs.isValidElementType(ForwardRefComponent); // true
+ReactIs.isValidElementType(Context.Provider); // true
+ReactIs.isValidElementType(Context.Consumer); // true
+ReactIs.isValidElementType(React.createFactory("div")); // true
+```
+
+### Determining an Element's Type
+
+#### AsyncMode
```js
import React from "react";
@@ -24,7 +54,7 @@ ReactIs.isAsyncMode(