diff --git a/developer_manual/app/controllers.rst b/developer_manual/app/controllers.rst
index f88877e6f..70d3e6c9b 100644
--- a/developer_manual/app/controllers.rst
+++ b/developer_manual/app/controllers.rst
@@ -110,6 +110,30 @@ All those parameters can easily be accessed by adding them to the controller met
 
     }
 
+It is also possible to set default parameter values by using PHP default method values so common values can be ommited:
+
+.. code-block:: php
+
+    <?php
+    namespace OCA\MyApp\Controller;
+
+    use \OCP\AppFramework\Controller;
+
+    class PageController extends Controller {
+
+        /**
+         * @param int $id
+         */
+        public function doSomething($id, $name='john', $job='author') {
+            // GET ?id=3&job=killer
+            // $id = 3
+            // $name = 'john'
+            // $job = 'killer'
+        }
+
+    }
+
+
 Casting parameters
 ------------------
 URL, GET and application/x-www-form-urlencoded have the problem that every parameter is a string, meaning that::