diff --git a/docs/writing-steps/decorators.md b/docs/writing-steps/decorators.md
index 5e4a30bd..8817f36d 100644
--- a/docs/writing-steps/decorators.md
+++ b/docs/writing-steps/decorators.md
@@ -102,4 +102,7 @@ Feature: Some feature
 
     Scenario: Adding todos
       When I add todo "foo"   # <- will use AdminTodoPage
-```
\ No newline at end of file
+```
+
+## Limitations
+* Currently [custom parameter types](https://github.com/cucumber/cucumber-expressions?tab=readme-ov-file#custom-parameter-types) are not supported in decorator steps. Vote and track [#112](https://github.com/vitalets/playwright-bdd/issues/112) for the progress on that.
\ No newline at end of file
diff --git a/docs/writing-steps/playwright-style.md b/docs/writing-steps/playwright-style.md
index 45240982..dc14e61a 100644
--- a/docs/writing-steps/playwright-style.md
+++ b/docs/writing-steps/playwright-style.md
@@ -26,6 +26,8 @@ When('I click link {string}', async ({ page }, name: string) => {
 
 > Usually step functions are async, but it is not required
 
+?> Calling `const { Given, When, Then } = createBdd()` at the top of each step file is totally ok, because it returns lightweight wrappers without heavy operations
+
 ## Fixtures
 To use [fixtures](https://playwright.dev/docs/test-fixtures#with-fixtures) in step definitions: