added example of satisfy validation (#107)

Author: AlexGalichenko

package-lock.json

@@ -14,17 +14,17 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.7.0",
-    "@docusaurus/preset-classic": "^3.7.0",
-    "@easyops-cn/docusaurus-search-local": "^0.49.2",
+    "@docusaurus/core": "^3.8.1",
+    "@docusaurus/preset-classic": "^3.8.1",
+    "@easyops-cn/docusaurus-search-local": "^0.52.1",
     "@mdx-js/react": "^3.1.0",
     "clsx": "^2.1.1",
     "prism-react-renderer": "^2.4.1",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "^3.7.0"
+    "@docusaurus/module-type-aliases": "^3.8.1"
   },
   "browserslist": {
     "production": [

package.json

@@ -3,14 +3,16 @@ sidebar_position: 5
 ---
 
 # @qavajs/xray-formatter
-Xray formatter for cucumber framework
+[Xray](https://docs.getxray.app/) formatter for cucumber framework
 
 ### Installation
 To install formatter run
 
-`npm install @qavajs/xray-formatter`
+```bash
+npm install @qavajs/xray-formatter
+```
 
-add to formatter section in config file
+configure `formatterOption` property in config file:
 
 cloud configuration:
 ```javascript

versioned_docs/version-2x/Formatters/xray-formatter.md

@@ -4,7 +4,7 @@ sidebar_position: 6
 
 # CI/CD
 **qavajs**, is CI/CD agnostic and can be executed in any environment that satisfies following requirements:
-- [nodejs](https://nodejs.org/en) with npm > 18
+- [nodejs](https://nodejs.org/en) > 20
 - installed browsers (for UI testing)
 
 ## General Approach for qavajs in CI/CD:

versioned_docs/version-2x/Guides/cicd.md

@@ -4,7 +4,7 @@ sidebar_position: 3
 
 # Parallel Execution
 Framework support parallel execution out of the box. 
-Number of parallel threads can be set in config file (by default it is config.js)
+Number of parallel threads can be set in config file (by default it is config file)
 ```typescript
 export default {
     // other configs

versioned_docs/version-2x/Guides/parallel.md

@@ -94,6 +94,21 @@ match [ajv](https://www.npmjs.com/package/ajv) schema
 Then I expect '$object' to match schema '$schema'
 ```
 
+## satisfy
+verify user-defined expectation provided as predicate
+
+```Gherkin
+Then I expect '$value' to satisfy '$either(1, 2)'
+```
+where `$either` is a predicate applied on first argument
+```typescript
+function either(...expected) {
+    return function (actual) {
+        return expected.includes(actual)
+    }
+}
+```
+
 ## Using in custom steps
 You can also use validations in custom steps
 

versioned_docs/version-2x/Guides/validation.mdx

@@ -37,7 +37,7 @@ export default {
             browserName: 'chromium'
         }
     },
-    pageObject: App
+    pageObject: new App()
 }
 ```
 
@@ -69,6 +69,7 @@ export default {
 
 ## Screenshot
 @qavajs/steps-playwright can also take screenshot on particular event.
+
 - onFail
 - beforeStep
 - afterStep
@@ -86,6 +87,7 @@ export default {
 
 ## Traces
 @qavajs support capturing playwright traces. https://playwright.dev/docs/next/trace-viewer-intro
+
 Supported events:
 - onFail
 - afterScenario
@@ -106,7 +108,8 @@ export default {
 ```
 
 ## Video
-@qavajs supports video recording. https://playwright.dev/docs/next/videos
+@qavajs supports video recording https://playwright.dev/docs/next/videos
+
 Supported events:
 - onFail
 - afterScenario
@@ -126,7 +129,7 @@ export default {
 ```
 
 ## Reuse Session
-_reuseSession_ flag allows to share driver session between tests. Browser will not be closed automatically after test.
+`reuseSession` flag allows to share driver session between tests. Browser will not be closed automatically after test.
 
 ```typescript
 export default {
@@ -137,7 +140,7 @@ export default {
 ```
 
 ## Restart Browser
-_restartBrowser_ flag allows to restart browser between tests instead of default restarting context
+`restartBrowser` flag allows to restart browser between tests instead of default restarting context
 
 ```javascript
 export default {
@@ -168,7 +171,7 @@ mouse button to interact
 - right
 - middle
 
-## Context variables
+## Context properties
 @qavajs/steps-playwright exposes following world variables
 
 | variable                  | type             | description                                                     |

versioned_docs/version-2x/Steps/playwright.md

@@ -38,12 +38,13 @@ export default {
             browserName: 'chrome'
         }
     },
-    pageObject: App
+    pageObject: new App()
 }
 ```
 
 ## Screenshot
 @qavajs/steps-wdio has build-in capability to take screenshot on particular event.
+
 - onFail
 - beforeStep
 - afterStep
@@ -59,6 +60,7 @@ export default {
 
 ## Snapshot
 @qavajs/steps-wdio has build-in capability to take snapshot on particular event.
+
 - onFail
 - beforeStep
 - afterStep
@@ -72,7 +74,7 @@ export default {
 ```
 
 ## Reuse Session
-_reuseSession_ flag allows to share driver session between tests. Browser will not be closed automatically after test.
+`reuseSession` flag allows to share driver session between tests. Browser will not be closed automatically after test.
 
 ```typescript
 export default {
@@ -105,7 +107,7 @@ mouse button to interact
 - right
 - middle
 
-## Context variables
+## Context properties
 @qavajs/steps-wdio exposes following world variables
 
 | variable         | type             | description                          |