diff --git a/README.rst b/README.rst
index 2c9a554..108e558 100644
--- a/README.rst
+++ b/README.rst
@@ -130,6 +130,29 @@
             enabled: true
             password: magicunicorn
 
+Proxy buffering
+
+.. code-block:: yaml
+
+    nginx:
+      server:
+        enabled: true
+        bind:
+          address: '0.0.0.0'
+          ports:
+          - 80
+        site:
+          gitlab_proxy:
+            enabled: true
+            type: proxy
+            proxy:
+              buffer:
+                number: 8
+                size: 16
+            host:
+              name: gitlab.domain.com
+              port: 80
+
 Read more
 =========