Refactor README for clarity and structure

Updated README to improve clarity and formatting.

Author: AminaSaoudi

README.md

@@ -1,91 +1,103 @@
 # Selenium-Python-E2E-Testing-Suite
 End-to-End UI test automation for a live e-commerce site – 100% open source, CI-ready, Allure reports, and Dockerized.
 
-This project was built from scratch to demonstrate a professional, scalable, and maintainable test automation framework using industry-best-practices.
+This project was built from scratch to demonstrate a professional test automation framework using industry best practices.
+
+### Target Site :
 
-🎯 Target Site
 URL: https://www.saucedemo.com/
 
-✨ Key Features
-Page Object Model (POM): Fully implemented for clean, maintainable, and reusable test code.
+### Key Features :
 
-Pytest Framework: Leverages pytest for test running, fixtures, and assertions.
+Page Object Model (POM) for clean, maintainable, and reusable test code.
 
-Allure Reports: Generates beautiful, interactive, and shareable HTML reports with step-by-step logging.
+Pytest Framework for test running, fixtures, and assertions.
 
-Dockerized: The entire suite is containerized with docker-compose. It runs a standalone Selenium Grid headlessly, making it CI/CD ready.
+Allure Reports: Generates interactive and shareable HTML reports with step-by-step logging.
 
-Robust Waiting: Uses Docker healthchecks to ensure tests only run when the Selenium Grid is 100% ready, eliminating flaky "wait" scripts.
+Dockerized: The entire suite is containerized with docker-compose. It runs a standalone Selenium Grid headlessly, making it CI/CD ready.
 
 Data-Driven: All test data (users, passwords, errors) is stored externally in data/test_data.json.
 
 Configuration Management: Environment details (like the base_url) are stored in pytest.ini, not hardcoded.
 
-🚀 How to Run
-1. The Docker / CI-Ready Way (Recommended)
-This is the simplest and most reliable way to run the entire suite. It runs headlessly and exactly as it would in a CI/CD pipeline.
-
-Prerequisites:
+### How to Run Using Docker
 
-[suspicious link removed] installed and running.
+**Prerequisites:**
 
-Run the Suite:
+Docker installed and running.
 
-Bash
 
-# 1. Clone the repository
-git clone [https://github.com/YOUR_USERNAME/Selenium-Python-E2E-Testing-Suite.git](https://github.com/YOUR_USERNAME/Selenium-Python-E2E-Testing-Suite.git)
+**Clone the repository**
+```
+git clone https://github.com/AminaSaoudi/Selenium-Python-E2E-Testing-Suite.git
 cd Selenium-Python-E2E-Testing-Suite
-2. Build and run the containers
+```
+
+**Build and run the containers**
+
 This command will:
+
 - Build the 'python-tests' image
 - Start the 'selenium' container
 - Wait for Selenium to be healthy
 - Run pytest, then stop everything.
+```
 docker-compose up --build --abort-on-container-exit
+```
 
+### How to Run on your local machine
 
-### 2\. The Local / Development Way
 Use this method if you want to run tests locally for development or debugging.
 
-Prerequisites:
+*Prerequisites:*
 
 Python 3.10+
 
 Google Chrome
 
 Allure (for viewing reports)
 
-Run the Suite:
+**Clone the repository**
 
-Bash
-
-# 1. Clone the repository
-git clone [https://github.com/YOUR_USERNAME/Selenium-Python-E2E-Testing-Suite.git](https://github.com/YOUR_USERNAME/Selenium-Python-E2E-Testing-Suite.git)
+```
+git clone https://github.com/AminaSaoudi/Selenium-Python-E2E-Testing-Suite.git
 cd Selenium-Python-E2E-Testing-Suite
-2. Create and activate a virtual environment
+```
+
+**Create and activate a virtual environment**
+
+```
 python -m venv venv source venv/bin/activate # (or .\venv\Scripts\activate on Windows)
+```
 
-3. Install dependencies
+**Install dependencies**
+
+```
 pip install -r requirements.txt
+```
+
+**Run pytest**
 
-4. Run pytest
 (This will run locally using webdriver-manager)
+```
 pytest
+```
+
 
+### Viewing the Allure Report
 
------
-📊 Viewing the Allure Report
 After running the tests (with either method), your test results are in the allure-results folder.
 
-Make sure you have Allure installed (scoop install allure or brew install allure).
+Make sure you have Allure installed
+
+```scoop install allure or brew install allure```
 
 Serve the report:
 
-```bash
+```
 allure serve allure-results
 ```
-Your browser will automatically open with a beautiful, interactive dashboard.
+Your browser will automatically open with a beautiful, interactive dashboard (Example below)
 
-```
-```
+<img width="1857" height="888" alt="image" src="https://github.com/user-attachments/assets/64a96f21-e8e4-4fd0-8dcf-f05472fbb2e4" />