From cbcb80c247120819296a2ee3e1f737a6780cdcd5 Mon Sep 17 00:00:00 2001
From: asmhatre <asmhatre@gmail.com>
Date: Sat, 25 Jul 2026 05:36:45 +0000
Subject: [PATCH] Add README

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..124116d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# sdjpa4-demo
+
+Runnable companion project for [Spring Data JPA 3 to 4 Migration Guide](https://ankurm.com/spring-data-jpa-3-to-4-migration-guide-2/) on ankurm.com.
+
+Four entities, two repositories, a `@NullMarked` package, seven passing behavior tests, and an A-G demo runner that prints every labelled console output shown in the article. Boots H2 in memory, so there's nothing to install beyond a JDK.
+
+Built and verified on Eclipse Temurin JDK 21.0.11, Spring Boot 4.0.6, Spring Data JPA 4.0.6, Hibernate ORM 7.2, H2 in-memory.
+
+## Run it
+
+```
+git clone https://ankurm.com/git.app/asmhatre/sdjpa4-demo.git
+cd sdjpa4-demo
+./mvnw spring-boot:run   # prints the labelled A-G demonstrations
+./mvnw test               # runs the 7 behavior tests (all green)
+```