Merge pull request #243 from cucumber/fixdoc

docs: ✏️ Add a note about static hooks and objects

Author: gaeljw

docs/hooks.md

@@ -9,6 +9,8 @@ See the [reference documentation](https://docs.cucumber.io/docs/cucumber/api/#ho
 
 Static hooks run once before/after all scenarios.
 
+**Note:** static hooks can only be defined inside `object`s (not classes).
+
 ### BeforeAll
 
 `BeforeAll` hooks run once before all scenarios.

docs/usage.md

@@ -47,7 +47,8 @@ class MyStepDefinitions extends StepsForThis with StepsForThat {
 
 You can also define glue code in **objects**.
 
-It's **not recommended** though, because by definition objects are singleton and if your glue code is stateful you will probably have "state conflicts" between your scenarios.
+Be aware that by definition objects are singleton and if your glue code is stateful you will probably have "state conflicts"
+between your scenarios if you use shared variables from objects.
 
 ## Running Cucumber tests