Issue #23 SEO: update README title/intro; enrich POM names/descriptions (verify: grep 'java.util.json' in README and run 'mvn -q help:evaluate -Dexpression=project.description' per module)

Author: simbo1905

README.md

@@ -1,6 +1,11 @@
-# java.util.json Backport for JDK 21
+# java.util.json – Official JSON API Backport for Java 21
 
-Early access to the unstable `java.util.json` API — taken from the OpenJDK jdk-sandbox “json” branch as of 2025-09-04.
+Early access backport of the proposed `java.util.json` JDK API (from the OpenJDK jdk‑sandbox “json” branch) for use on Java 21+.
+This project provides the standard JSON API for Java ahead of time: immutable JSON value types, parsing utilities, and examples aligned with a potential future JEP.
+
+References:
+- OpenJDK sandbox “json” branch: https://github.com/openjdk/jdk-sandbox/tree/master/src/java.json
+- Design paper: [Towards a JSON API for the JDK.pdf](Towards%20a%20JSON%20API%20for%20the%20JDK.pdf)
 
 ## Quick Start
 
@@ -43,7 +48,7 @@ JsonValue backToJson = Json.fromUntyped(Map.of(
 ));
 ```
 
-## Back Port Project Goals
+## Backport Project Goals
 
 - **✅Enable early adoption**: Let developers try the unstable Java JSON patterns today on JDK 21+
 - **✅API compatibility over performance**: Focus on matching the emerging "batteries included" API design rather than competing with existing JSON libraries on speed. 
@@ -82,7 +87,7 @@ This is a simplified backport with the following changes from the original:
 
 These vulnerabilities exist in the upstream OpenJDK sandbox implementation and are reported here for transparency.
 
-## JSON Schema Validator
+## JSON Schema Validator (2020-12)
 
 By including a basic schema validator that demonstrates how to build a realistic feature out of the core API. To demonstrate the power of the core API, it follows Data Oriented Programming principles: it parses JSON Schema into an immutable structure of records, then for validation it parses the JSON to the generic structure and uses the thread-safe parsed schema as the model to validate the JSON being checked.
 
@@ -99,7 +104,7 @@ var result = schema.validate(
 // result.valid() => true
 ```
 
-Compatibility: we run the official 2020-12 JSON Schema Test Suite on verify; in strict mode it currently passes about 71% of applicable cases.
+Compatibility: runs the official 2020‑12 JSON Schema Test Suite on `verify`; in strict mode it currently passes about 71% of applicable cases.
 
 ## Building
 

json-compatibility-suite/pom.xml

@@ -13,11 +13,8 @@
     <artifactId>json-compatibility-suite</artifactId>
     <packaging>jar</packaging>
 
-    <name>java.util.json Java21 Backport JSONTestSuite</name>
-
-    <description>
-        A module to run the official JSON Test Suite against the java.util.json backport for Java 21.
-    </description>
+    <name>java.util.json Java21 Backport – JSON Test Suite</name>
+    <description>Runs the official JSON Test Suite against the java.util.json Java 21 backport to track conformance with JSON standards.</description>
 
     <dependencies>
         <dependency>

json-java21-api-tracker/pom.xml

@@ -14,6 +14,7 @@
     <packaging>jar</packaging>
 
     <name>java.util.json Java21 Backport Upstream API Tracker</name>
+    <description>Compares the OpenJDK sandbox java.util.json API to this Java 21 backport and reports differences to maintain alignment with upstream.</description>
 
     <properties>
         <maven.compiler.release>21</maven.compiler.release>

json-java21-schema/pom.xml

@@ -13,12 +13,8 @@
 
     <artifactId>java.util.json.schema</artifactId>
     <packaging>jar</packaging>
-    <name>java.util.json Java21 Backport JSON Schema Validator</name>
-
-    <description>
-        A JSON Schema validator implementation written with the experiment java.util.json API backport for Java 21.
-        This module includes an integration test suite that runs the official JSON Schema Test Suite.
-    </description>
+    <name>java.util.json Java21 Backport – JSON Schema Validator (2020-12)</name>
+    <description>Experimental JSON Schema 2020-12 validator built using the java.util.json Java 21 backport; includes integration tests running the official JSON Schema Test Suite.</description>
 
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

json-java21/pom.xml

@@ -13,7 +13,8 @@
     <artifactId>java.util.json</artifactId>
     <packaging>jar</packaging>
 
-    <name>java.util.json Java21 Backport</name>
+    <name>java.util.json Java21 Backport (Core)</name>
+    <description>Backport of the OpenJDK sandbox java.util.json API for Java 21+. Immutable JSON value types and parsing utilities aligned with the future JDK standard library.</description>
 
     <dependencies>
         <dependency>

pom.xml

@@ -10,7 +10,7 @@
     <packaging>pom</packaging>
 
     <name>java.util.json Java21 Backport Parent</name>
-    <description>A backport of the upcoming java.util.json API for Java 21+</description>
+    <description>Backport of the OpenJDK sandbox java.util.json API for Java 21+. Provides immutable JSON value types and parsing utilities aligned with a potential future JDK JSON API.</description>
     <url>https://simbo1905.github.io/java.util.json.Java21/</url>
 
     <licenses>