Skip to content

Add a comprehensive readme to the project#9

Merged
marmoure merged 3 commits intomainfrom
doc/readme
Jan 29, 2026
Merged

Add a comprehensive readme to the project#9
marmoure merged 3 commits intomainfrom
doc/readme

Conversation

@marmoure
Copy link
Collaborator

@marmoure marmoure commented Jan 21, 2026

Create a Readme for the project with the intent to:

  1. explain what it does
  2. project features
  3. how to run it
  4. API docs
  5. Configurations

@marmoure marmoure force-pushed the doc/readme branch 4 times, most recently from a62e342 to 41ef88a Compare January 22, 2026 12:23
README.md Outdated
- Java 21
- Maven 3.6+
# Broadband label file Validator Service
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Developed by [Evolved Binary](https://www.evolvedbinary.com/) -> Developed for [Comcast](https://www.comcast.com) by [Evolved Binary](https://www.evolvedbinary.com)

README.md Outdated
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.

## Running the Application
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please link The National Archives to https://www.nationalarchives.gov.uk/

README.md Outdated

* **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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

broadband label should be capitalised throughout this README.md please

README.md Outdated
## Built With

* [Java 21](https://openjdk.org/projects/jdk/21/) - Programming Language
* [Micronaut 4](https://micronaut.io/) - The JVM-based framework used
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The JVM-based framework used -> A Web Application framework

README.md Outdated

* [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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Template engine for the Web Views -> Provides templating for the Web Pages.

README.md Outdated
```

## Using Docker:
Build the JAR
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Build the JAR -> ### Building an Application Package

README.md Outdated
```
Use the absolute path to the schemas directory when running the docker container.

Using Docker
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is both building the Docker Container and running the Docker Container - should be split into 2 separate L3 sections. Building it will be optional as we will publish it on Docker Hub. Also again, we need some information about what they are doing here and what the result is and how to use it please

README.md Outdated

Web: https://www.evolvedbinary.com.

Phone: +44 (0)2032 397236 / +1 917 267-8787. No newline at end of file
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove the phone number.

README.md Outdated
## Contact and Support
Evolved Binary Limited

Email: admin@evolvedbinary.com.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove the trailing .

README.md Outdated

Email: admin@evolvedbinary.com.

Web: https://www.evolvedbinary.com.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please remove the trailing .

@marmoure marmoure requested review from adamretter and removed request for adamretter January 29, 2026 00:19
Copy link
Member

@adamretter adamretter left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - thanks Younes

@marmoure marmoure merged commit aaa3f19 into main Jan 29, 2026
3 checks passed
@marmoure marmoure deleted the doc/readme branch January 30, 2026 11:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants