docs: add withRipple() docs

Author: streamich

README.md

@@ -77,7 +77,7 @@ const MyComponent = mock();
      - [`<Portal>`](./docs/en/Portal.md), [`<Overlay>`](./docs/en/Overlay.md), and [`<Modal>`](./docs/en/Modal.md)
      - [`<FullScreen>`](./docs/en/FullScreen.md)
      - [`<Slider>`](./docs/en/Slider.md)
-     - [`<Ripple>`](./docs/en/Ripple.md) &mdash; [**example**](https://codesandbox.io/s/983q7jr80o)
+     - [`<Ripple>`](./docs/en/Ripple.md) and [`withRipple`](./docs/en/Ripple.md#withripple) &mdash; [**example**](https://codesandbox.io/s/983q7jr80o)
      - [`<Audio>`](./docs/en/Audio.md) and [`<Video>`](./docs/en/Video.md)
      - [`<Speak>`](./docs/en/Speak.md), [`<Vibrate>`](./docs/en/Vibrate.md), [`<Alert>`](./docs/en/Alert.md), `<Prompt>`, `<Confirm>`
   - [Side Effects](./docs/en/Side-effects.md)

docs/en/README.md

@@ -46,7 +46,7 @@
      - [`<Portal>`](./Portal.md), [`<Overlay>`](./Overlay.md), and [`<Modal>`](./Modal.md)
      - [`<FullScreen>`](./FullScreen.md)
      - [`<Slider>`](./Slider.md)
-     - [`<Ripple>`](./Ripple.md)
+     - [`<Ripple>`](./Ripple.md) and [`withRipple`](./Ripple.md#withripple) &mdash; [**example**](https://codesandbox.io/s/983q7jr80o)
      - [`<Audio>`](./Audio.md) and [`<Video>`](./Video.md)
      - [`<Speak>`](./Speak.md), [`<Vibrate>`](./Vibrate.md), [`<Alert>`](./Alert.md), `<Prompt>`, `<Confirm>`
   - [Side Effects](./Side-effects.md)

docs/en/Ripple.md

@@ -23,3 +23,17 @@ import {Ripple} from 'libreact/lib/Ripple';
 
 - `color` — optional, string, ripple color.
 - `ms` — optional, number, animation time in milliseconds.
+
+
+## `withRipple()`
+
+A higher order component that transforms plain DOM type elements into ones with ripple effects.
+
+```js
+import {withRipple} from 'libreact/lib/Ripple';
+
+const DivWithRipple = withRipple('div');
+const ButtonWithRipple = withRipple('button', {ms: 1000, color: red});
+```
+
+As an optional second arguments accepts props to provide to `<Ripple>` component.