diff --git a/docs/sources/reference/functions.md b/docs/sources/reference/functions.md
index 2dbc2a5..fe7e580 100644
--- a/docs/sources/reference/functions.md
+++ b/docs/sources/reference/functions.md
@@ -16,6 +16,8 @@ groupBy($__range, avg)
 percentile($__range_series, 95) - 95th percentile over all values
 ```
 
+---
+
 ## Transform
 
 
@@ -25,7 +27,7 @@ percentile($__range_series, 95) - 95th percentile over all values
 groupBy(interval, function)
 ```
 
-Takes each timeseries and consolidate its points falled in given _interval_ into one point using _function_, which can be one of: _avg_, _min_, _max_, _median_.
+Takes each timeseries and consolidate its points fallen in the given _interval_ into one point using _function_, which can be one of: _avg_, _min_, _max_, _median_.
 
 Examples:
 ```
@@ -139,7 +141,7 @@ Replaces `null` values with N
 aggregateBy(interval, function)
 ```
 
-Takes all timeseries and consolidate all its points falled in given _interval_ into one point using _function_, which can be one of: _avg_, _min_, _max_, _median_.
+Takes all timeseries and consolidate all its points fallen in the given _interval_ into one point using _function_, which can be one of: _avg_, _min_, _max_, _median_.
 
 Examples:
 ```
@@ -157,6 +159,20 @@ This will add metrics together and return the sum at each datapoint. This method
 
 ---
 
+### _percentile_
+```
+percentile(interval, N)
+```
+Takes all timeseries and consolidate all its points fallen in the given _interval_ into one point by Nth percentile.
+
+Examples:
+```
+percentile(1h, 99)
+percentile($__range_series, 95) - 95th percentile over all values
+```
+
+---
+
 ### _average_
 ```
 average(interval)