diff --git a/README.md b/README.md
index 33f6be1..1cb8691 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,22 @@ worked out over time.
 
 `raven` is only tested under linux. NT and Darwin support is **not** guaranteed.
 
+WSL *may* affect the behaviour of raven. Quirks to be worked out.
+
+## Getting Started
+
+```bash
+raven new demo
+cd demo
+raven run main.Main
+```
+
 ## Future plans
 
+- [ ] Fix `raven test`. Totally borked.
 - [ ] Make `nest run` fall back to an entry point specified in Nest.toml, when
     none provided.
+- [ ] Fix project structure, eliminate inter-dependencies.
+  - [ ] Separate out `java.rs` into a dedicated wrapper library.
 - [ ] Possibly add support for pulling remote packages via `nest add`. This
     will be implemented should there arise a need.