enhanced site

Author: adrian-herscu

docs/architecture.md

@@ -1,4 +1,4 @@
-##   Architecture
+#   Architecture
 
 > Support for additional technologies, e.g. RabbitMQ, can be added by sub-classing these classes and adding specific steps, setup/teardown, and configuration. This allows reusing the basic configuration, reporting, logging, and retrying mechanisms. Further, application tests, steps, and configurations reuse by subclassing from technologies.
 

docs/example-tests.md

@@ -1,26 +1,30 @@
-## Example Tests
+# Example Tests
 
 Below are example test cases demonstrating BDD-style usage with this framework:
 
+## UI search test
+
 ```python
-# Example: UI search test
-# (Assumes self.login_section and self._configuration.users are defined)
 def should_find(self):
-    self.login_section(random.choice(self._configuration.users))
+    (self.login_section(self.configuration.random_user)
+        .when.clicking_search())
+
     for word in ["hello", "kitty"]:
         (self.steps
             .when.searching_for(word)
-            .then.the_search_hints(
-                yields_item(contains_string_ignoring_case(word))))
+            .then.the_search_hints(yields_item(traced(
+                contains_string_ignoring_case(word)))))
 ```
 
+## API add test
+
 ```python
-# Example: API add test
 def should_add(self):
     random_pet = SwaggerPetstorePet.random()
     (self.steps
+        .given.swagger_petstore(self.rest_session)
         .when.adding(random_pet)
-        .then.the_available_pets(yields_item(is_(random_pet))))
+        .then.the_available_pets(yields_item(traced(is_(random_pet)))))
 ```
 
 ---

docs/getting-started.md

@@ -1,4 +1,4 @@
-## 🚀 Quick Start (Locally with [PDM](https://pdm-project.org))
+# Getting Started
 
 Open in Codespace or Dev Container and everything will get installed and configured, otherwise:
 

docs/project-structure.md

@@ -1,4 +1,4 @@
-## 📦 Project Structure
+# Project Structure
 
 ```
 qa-automation-python/