diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..fe61b1f
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.vale.ini
diff --git a/README.md b/README.md
index 90f0094..e10f105 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,33 @@
 # java-scratchspace
 
-combined effort to get a better java environment for CRUX
\ No newline at end of file
+combined effort to get a better java environment for CRUX
+
+## History
+
+This repository preserves efforts to achieve a clear and clean openjdk toolchain.
+Most work has been done by [John Vogel](https://crux.nu/Main/RetiredMembers) (to my knowledge) outside of this git tree, and when he left it was picked up by [Danny Rawlins](https://crux.nu/Profiles/DanielRawlins) and [myself](https://crux.nu/Profiles/TimBiermann).
+
+## Goals
+
+There is things this repository tried and still tries to achieve:
+
+ - provide ports to bootstrap openjdk release builds
+ - prepare new 
+ - work on scripts to make dealing with java less painful
+
+## Non-Goals
+
+And there is things that this repository does not want to achieve:
+
+ - provide everything java-related.
+
+## State
+
+**No support guaranteed**
+
+There is no active development for openjdk right now.
+Every once in a while this repository gets used to build a new boot jdk and prepare a new port (e.g. in case of a major release) for contrib.
+
+There are a few more java related ports like `ant` and `kotlin` in here.
+These are not guaranteed to work in any way.
+However, tickets and pull requests are welcome.