diff --git a/CHANGELOG.md b/CHANGELOG.md
index 825c32f..aec724b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1 +1,5 @@
 # Changelog
+
+## v0.1.0 - 2023-08-08
+
+First release
diff --git a/README.md b/README.md
index 7048eec..0b5b7b7 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
 # zon2nix
+
+Convert the dependencies in `build.zig.zon` to a Nix expression
+
+## Usage
+
+```bash
+zon2nix > deps.nix
+zon2nix zls > deps.nix
+zon2nix zls/build.zig.zon > deps.nix
+```
+
+To use the generated file, add this to your Nix expression:
+
+```nix
+postPatch = ''
+  ln -s ${callPackage ./deps.nix { }} $ZIG_GLOBAL_CACHE_DIR/p
+'';
+```