diff --git a/docs/guide/fastapi_transition.md b/docs/guide/fastapi_transition.md
index 6ae179e24..7a3670049 100644
--- a/docs/guide/fastapi_transition.md
+++ b/docs/guide/fastapi_transition.md
@@ -1,3 +1,17 @@
+
+## Defining a route with path parameters
+**old:**
+```python
+# with <> 
+@offlineshop_ext.route("/lnurl/<item_id>", methods=["GET"])
+```
+
+**new:**
+```python
+# with curly braces: {}
+@offlineshop_ext.get("/lnurl/{item_id}")
+```
+
 ## Check if a user exists and access user object
 **old:**
 ```python