diff --git a/README.md b/README.md
index 15604730..8a7bdecc 100644
--- a/README.md
+++ b/README.md
@@ -97,7 +97,7 @@
   - [`useSessionStorage`](./docs/useSessionStorage.md) — manages a value in `sessionStorage`.
   - [`useThrottle` and `useThrottleFn`](./docs/useThrottle.md) — throttles a function. [![][img-demo]](https://streamich.github.io/react-use/?path=/story/side-effects-usethrottle--demo)
   - [`useTitle`](./docs/useTitle.md) — sets title of the page.
-  - [`usePermission`](./docs/usePermission.md) — query permission from the user depends on the specific API.
+  - [`usePermission`](./docs/usePermission.md) — query permission status for browser APIs.
     <br/>
     <br/>
 - [**Lifecycles**](./docs/Lifecycles.md)
diff --git a/docs/usePermission.md b/docs/usePermission.md
index cc793240..4c0080b2 100644
--- a/docs/usePermission.md
+++ b/docs/usePermission.md
@@ -1,7 +1,6 @@
 # `usePermission`
 
-React side-effect hook that query permission status from the user depends on the specific API.
-
+React side-effect hook to query permission status of browser APIs.
 
 ## Usage