docs: improve battery docs

Author: streamich

README.md

@@ -35,7 +35,7 @@ const MyComponent = mock();
      - [`delayed()`](./docs/delayed.md)
      - [`invert()`](./docs/invert.md)
   - Sensors
-     - [`<BatterySensor>`](./docs/BatterySensor.md), `withBattery()`, and `@withBattery`
+     - [`<BatterySensor>`](./docs/BatterySensor.md), [`withBattery()`](./docs/BatterySensor.md#withbattery), and [`@withBattery`](./docs/BatterySensor.md#@withbattery)
      - [`<MediaDeviceSensor>`](./docs/MediaDeviceSensor.md)
      - [`<MediaSensor>`](./docs/MediaSensor.md)
      - [`<NetworkSensor>`](./docs/NetworkSensor.md) and [`withNetwork()`](./docs/NetworkSensor.md#withnetwork)

docs/BatterySensor.md

@@ -1,12 +1,12 @@
-# `BatterySensor`
+# `<BatterySensor>`
 
 Uses [`Navigator.getBattery()`](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/getBattery) API to track battery level, charging status and time it takes to charge/discharge a battery.
 
-# Props
+## Props
 
 None.
 
-# Example
+## Example
 
 ```jsx
 import {BatterySensor} from 'libreact/lib/BatterySensor';
@@ -26,3 +26,39 @@ Result
     "dischargingTime": null
 }
 ```
+
+## `withBattery()`
+
+Higher order component that injects `battery` prop into your component.
+
+```js
+import {withBattery} from 'libreact/lib/BatterySensor';
+
+const MyCompWithBattery = withBattery(MyComp);
+```
+
+Overwrite the inject prop name
+
+```js
+const MyCompWithBattery = withBattery(MyComp, 'myBattery');
+```
+
+or merge the props
+
+```js
+const MyCompWithBattery = withBattery(MyComp, null);
+```
+
+
+## `@withBattery`
+
+Statefull component class decorator that injects `battery` prop into your component.
+
+```js
+import {withBattery} from 'libreact/lib/BatterySensor';
+
+@withBattery
+class MyComp extends Component {
+
+}
+```