diff --git a/README.md b/README.md
index 01102fd..2faf772 100644
--- a/README.md
+++ b/README.md
@@ -2,4 +2,11 @@
 
 ![spring-logo](https://user-images.githubusercontent.com/30401054/190108397-288a1c39-e26b-4657-8951-cd912105bb60.png)
 
-Spring boot java implementation of realworld example.app
+> ### [Spring Boot] codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the [RealWorld](https://github.com/gothinkster/realworld) spec and API.
+
+
+This codebase was created to demonstrate a fully fledged fullstack application built with **[Spring Boot]** including CRUD operations, authentication, routing, pagination, and more.
+
+We've gone to great lengths to adhere to the **[Spring Boot]** community styleguides & best practices.
+
+For more information on how to this works with other frontends/backends, head over to the [RealWorld](https://github.com/gothinkster/realworld) repo.