message: docs: update use-controllable docs
diff: @@ -4,21 +4,36 @@ package: "@chakra-ui/hooks"
  description: React hook to handle controlled vs uncontrolled component scenarios
  ---
  -React hook allows component have
  +React hook that allows any component handle
  [controlled](https://reactjs.org/docs/forms.html#controlled-components) and
  [uncontrolled](https://reactjs.org/docs/uncontrolled-components.html) modes, and
  provide control over its internal state.
  -Most Chakra components utilize `useControllableState` for seamlessly managing
  -regardless of whether it is controlled or uncontrolled.
  +Most Chakra components use the `useControllableState` for seamlessly managing
  +both controlled or uncontrolled state scenarios.
  ## Import
  ```js
  -import { useControllableState } from "@chakra-ui/core"
  +import { useControllableProp, useControllableState } from "@chakra-ui/core"
  ```
  -## Signature
  +## useControllableProp
  +
  +Given a prop value and state value, the `useControllableProp` hook is used to
  +determine whether a component is controlled or uncontrolled, and also returns
  +the computed value.
  +
  +- It returns the prop value if the component is controlled
  +- It returns the state value if the component if uncontrolled
  +
  +### Usage
  +
  +```jsx live=false
  +const [isControlled, value] = useControllableProp(propValue, stateValue)
  +```
  +
  +## useControllableState
  The `useControllableState` hook returns the state and function that updates the
  state, just like `React.useState` does.
  @@ -27,10 +42,11 @@ state, just like `React.useState` does.
  const [value, setValue] = useControllableState(options)
  ```
  -## Basic usage
  +### Usage
  -Using this hook lets you use the initial state by default with an option to
  -control the state via control props (using `value`).
  +With `useControllableState`, you can pass an initial state (using
  +`defaultValue`) implying the component is uncontrolled, or you can pass a
  +controlled value (using `value`) implying the component is controlled.
  Here's an example of an uncontrolled state.
  