diff --git a/pages/_docs/range-slider.md b/pages/_docs/range-slider.md
index ede038335..949415b93 100644
--- a/pages/_docs/range-slider.md
+++ b/pages/_docs/range-slider.md
@@ -8,56 +8,93 @@ All options and features can be found [**here**](https://refreshless.com/nouisli
### Basic range slider
{% example %}
-
-
+
+
{% endexample %}
-## Options
+That's how values are displayed:
+
+```js
+/* Demo only */
+
+$(document).ready(function() {
+ /* Sliders value */
+ let slidersText = document.querySelectorAll('[demo-slider]');
+ for(let i = 0;i
+
+{% endexample %}
+
+### start
+
+The `start` option sets the number of handles and corresponding start positions.
+
+The `start` option uses the slider's `'format'` option to decode the input. Number input will be cast to string and decoded.
{% example %}
-
+
-
+
-
+
{% endexample %}
-### Range
+### range
-Range sets the limits of the slider.
+All values on the slider are part of a range. The range has a minimum and maximum value. **The minimum value cannot be equal to the maximum value.**
{% example %}
-
+
-
+
-
+
{% endexample %}
-### Step
+### step
By default, the slider slides fluently. In order to make the handles jump between intervals, you can use the step option.
{% example %}
-
+
-
+
-
+
{% endexample %}
-### Connect
+### connect
The connect option can be used to control the bar between the handles or the edges of the slider.
@@ -68,44 +105,40 @@ Setting true sets the bars between the handles, but not between the handles and
{% example %}
-
+
-
+
-
+
{% endexample %}
-### Margin
+### margin
When using two handles, the minimum distance between the handles can be set using the margin option. The margin value is relative to the value set in 'range'. This option is only available on linear sliders.
{% example %}
-
+
-
+
{% endexample %}
-### Limit
+### limit
-The limit option is the oposite of the margin option, limiting the maximum distance between two handles. As with the margin option, the limit option can only be used on linear sliders.
+The `limit` option is the oposite of the margin option, limiting the maximum distance between two handles. As with the margin option, the `limit` option can only be used on linear sliders.
{% example %}
-
+
{% endexample %}
-### Padding
+### padding
Padding limits how close to the slider edges handles can be.
{% example %}
-
+
{% endexample %}
-### Orientation
-
-The orientation setting can be used to set the slider to `"vertical"` or `"horizontal"`.
-
-Set dimensions! Vertical sliders don't assume a default `height`, so you'll need to set one. You can use any unit you want, including `%` or `px`.
\ No newline at end of file
+That's only the basic features and options of range slider. More possibilities can be found [**here**](https://refreshless.com/nouislider/).
\ No newline at end of file