Add some basic documentation for ZJIT

1 files changed, 28 insertions, 0 deletions

diff --git a/doc/zjit.md b/doc/zjit.md
index e69de29bb2..7af7fadfa2 100644
--- a/doc/zjit.md
+++ b/doc/zjit.md
@@ -0,0 +1,28 @@
+# ZJIT: ADVANCED RUBY JIT PROTOTYPE
+
+## Build Instructions
+
+To build ZJIT on macOS:
+```
+./autogen.sh
+./configure --disable-yjit --enable-zjit=dev --prefix=$HOME/.rubies/ruby-yjit --disable-install-doc --with-opt-dir="$(brew --prefix openssl):$(brew --prefix readline):$(brew --prefix libyaml)"
+make -j miniruby
+```
+
+To run tests:
+```
+# You'll need to `brew install cargo-nextest` first:
+make zjit-test
+```
+
+## Useful dev commands
+
+To view YARV output for code snippets:
+```
+./miniruby --dump=insns --e0
+```
+
+To run code snippets with ZJIT:
+```
+./miniruby --zjit --e0
+```