diff --git a/README.md b/README.md
new file mode 100644
index 0000000..eecac62
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+# Java Composer
+
+This is a soft-fork of [JavaPoet](https://github.com/square/javapoet). JavaPoet appears to have been abandoned and is missing 
+support for post-Java 8 features. This repository exists solely to add those missing features until a time when JavaPoet 
+chooses to reactivate.
+
+Please see [JavaPoet](https://github.com/square/javapoet) for documentation, licensing, etc.
+
+# Changes From JavaPoet
+
+- Require Java 17