diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7c4656e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# notNull
+
+
+This project aim to test java nullability solution. Mainly around jsr-305
+- With google findbugs annotations
+- With spring annotations
+- With custom hand made annotations
+
+By defining annotation :
+- in module-info.java
+- in package-info.java
+
+
+Conclusion:
+
+module-info.java force to declare each dependency use by the project.
+
+package-info.java is not recursive and so should be added in each package/subpackage.
+
+external annotation spring/findbugs required maven dependencies (of courses).
+
+spring annotation are not compatible with module-info.
+