[doc] Improve the readme

Author: marmoure

README.md

@@ -1,36 +1,45 @@
 # Broadband label file Validator Service
-This project is a solution for validating Broadband label files against defined Schemas. Developed by [Evolved Binary](https://www.evolvedbinary.com/) ,to be used by the FCC https://www.fcc.gov/broadbandlabels, the system consists of a HTTP REST API and a user-friendly Web Application.
+This project provides a solution for validating Broadband Label files against defined Schemas. Developed by [Evolved Binary](https://www.evolvedbinary.com/) for use with the [FCC Broadband Labels](https://www.fcc.gov/broadbandlabels) initiative, the system consists of a HTTP REST API and a user-friendly Web Application.
 
-## Overview
-The Broadband label file Validator Service allows public users to validate Broadband label files against various variants and versions of Schema files. The project is built using Java 21 and is open-source under the Apache 2.0 License.
-
-The core validation logic is constructed around the Open Source [CSV Validator](https://github.com/digital-preservation/csv-validator) library originally built for The National Archives.
+The core validation logic is built upon the Open Source [CSV Validator](https://github.com/digital-preservation/csv-validator) library, originally developed for The National Archives.
 
 ## Features
 
-HTTP REST API: A robust API that exposes validation services to the internet.
+* **HTTP REST API**: A robust API that exposes validation services to the internet.
+* **Web Application**: A simple HTML5 interface allowing users to upload files or provide URLs for validation.
+* **Multiple Input Methods**: Support for validating broadband label files via direct file upload or external URL retrieval.
+* **Schema Management**: dynamically lists and utilizes validation schemas stored in the configured directory.
 
-Web Application: A simple HTML5 wrapper around the API allowing users to upload files or provide URLs for validation.
+## Endpoints
+Check the API documentation for more information https://app.swaggerhub.com/apis/evolvedbinary/bbl-validator-web-api/1.0.0#/schema/validateCsv.
 
-Multiple Input Methods: Support for validating CSVs via direct file upload or external URL retrieval.
+## Built With
 
-## Endpoints
-Check the API documentation for more information https://app.swaggerhub.com/apis/evolvedbinary/bbl-validator-web-api/1.0.0#/schema/validateCsv. 
+* [Java 21](https://openjdk.org/projects/jdk/21/) - Programming Language
+* [Micronaut 4](https://micronaut.io/) - The JVM-based framework used
+* [Apache Velocity](https://velocity.apache.org/) - Template engine for the Web Views
+* [Maven](https://maven.apache.org/) - Dependency Management
+* [Docker](https://www.docker.com/) - Containerization
 
 ## Prerequisites
-- Java 21
-- Maven 3.6+
+* Java 21
+* Maven 3.6+
 
-## Running the Application
+## Getting Started
 Using Maven
 
 ```bash
 git clone https://github.com/evolvedbinary/bbl-validator.git
 cd bbl-validator
-mvn clean compile
 mvn mn:run
 ```
 
+Build the JAR
+
+```bash
+mvn clean package
+```
+
 Using Docker
 
 ```bash
@@ -41,6 +50,30 @@ docker run -p 8080:8080 -v /path/to/schemas:/app/schemas:ro evolvedbinary/bbl-va
 ```
 
 note: use the absolute path to the schemas directory when running the docker container.
+
+## Usage
+
+### Web Interface
+Navigate to http://localhost:8080/views/validate in your browser. You can:
+
+1. Select a Schema ID from the dropdown.
+
+2. Choose to validate via URL or Content.
+
+3. View the validation status and any error messages in the results table.
+
+### HTTP API
+You can validate files programmatically using the API. Full documentation is available via:
+
+Online: [SwaggerHub API Docs](https://app.swaggerhub.com/apis/evolvedbinary/bbl-validator-web-api/1.0.0#/schema/validateCsv)
+
+Local Spec: The OpenAPI YAML file is available at `/static/openapi.yaml` on the running server.
+
+## Configuration
+The application uses application.yml for configuration.
+
+* Server Port: Defaults to `8080`.
+* Schema Directory: Defaults to `schemas` relative to the working directory.
 
 ## Contact and Support
 Evolved Binary Limited