diff --git a/README.md b/README.md
index db966005..0358f316 100644
--- a/README.md
+++ b/README.md
@@ -79,7 +79,7 @@
- [`useObservable`](./docs/useObservable.md) — tracks latest value of an `Observable`.
- [`useSetState`](./docs/useSetState.md) — creates `setState` method which works like `this.setState`. [![][img-demo]](https://codesandbox.io/s/n75zqn1xp0)
- [`useToggle` and `useBoolean`](./docs/useToggle.md) — tracks state of a boolean.
- - [`useCounter`](./docs/useCounter.md) — tracks state of a number.
+ - [`useCounter` and `useNumber`](./docs/useCounter.md) — tracks state of a number.
- [`useList`](./docs/useList.md) — tracks state of an array.
- [`useMap`](./docs/useMap.md) — tracks state of an object.
diff --git a/docs/useCounter.md b/docs/useCounter.md
index 30b0672c..a64102a8 100644
--- a/docs/useCounter.md
+++ b/docs/useCounter.md
@@ -2,20 +2,27 @@
React state hook that tracks a numeric value.
+`useNumber` is an alias for `useCounter`.
+
## Usage
```jsx
-import {useCounter} from 'react-use';
+import {useCounter, useNumber} from 'react-use';
const Demo = () => {
- const [value, inc, set] = useCounter();
+ const [value, {inc, dec, get, set, reset}] = useCounter(5);
return (