From a87c1340209fafe314ec24f6aeb8fa31f2ea690c Mon Sep 17 00:00:00 2001
From: Diana Pazheva <diana.pazheva@sap.com>
Date: Tue, 7 Jul 2026 12:21:54 +0300
Subject: [PATCH] fix(ui5): Enhance OPA5 configuration guidelines

---
 .../references/configuration.md                      | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/plugins/ui5/skills/ui5-best-practices-opa5/references/configuration.md b/plugins/ui5/skills/ui5-best-practices-opa5/references/configuration.md
index ec93c815..b1482058 100644
--- a/plugins/ui5/skills/ui5-best-practices-opa5/references/configuration.md
+++ b/plugins/ui5/skills/ui5-best-practices-opa5/references/configuration.md
@@ -1,25 +1,27 @@
 # Configuration
 
-1. Use this folder layout:
+1. Use this folder layout for page objects and journeys:
 ```
 test/integration/
-├── opaTests.qunit.js   ← single entry point
 ├── pages/
 │   ├── Welcome.js      ← one page object per view (name matches the view)
 │   ├── Items.js
 │   └── Browser.js      ← cross-view actions (navigation, hash)
 ├── WelcomeJourney.js   ← one journey per feature/functionality
 └── FilterItemsJourney.js
+└── ...
 ```
 
-2. **ALWAYS** enable `autoWait` and define `viewNamespace` globally in `opaTests.qunit.js`.
+2. Default test entry point is `test/integration/opaTest.qunit.js`. Skip this file if your instructions already specify a different test entry point.
+
+3. **ALWAYS** enable `autoWait` and define `viewNamespace` globally in the test entry point.
 ```javascript
-// opaTests.qunit.js
+// in the test entry point 
 sap.ui.define(["sap/ui/test/Opa5"], (Opa5) => {
 	"use strict";
     Opa5.extendConfig({
 		autoWait: true,
-		viewNamespace: "com.myorg.myapp.view."
+		viewNamespace: "com.myorg.myapp.view." // Replace with your actual app namespace
 	});
 	// ...
 });