diff --git a/README.md b/README.md
index 7f31f52f5..d2f53ae24 100644
--- a/README.md
+++ b/README.md
@@ -58,8 +58,7 @@ A browser window will open with `out.svg` and live-reload on changes to `in.d2`.
 
 ## Install
 
-For more detailed installation docs with examples for if you do not wish to use the
-install script see [./doc/INSTALL.md](./doc/INSTALL.md).
+For detailed installation docs with examples see [./docs/INSTALL.md](./docs/INSTALL.md).
 
 ### Install script
 
@@ -76,8 +75,9 @@ curl -fsSL https://d2lang.com/install.sh | sh -s --
 
 We have precompiled binaries on the [releases](https://github.com/terrastruct/d2/releases)
 page for macOS and Linux. For both amd64 and arm64. We will release package manager
-distributions like .rpm, .deb soon. We also want to get D2 on Homebrew for macOS
-and release a docker image.
+distributions like .rpm, .deb soon. d2 is on homebrew with our tap. See [./docs/INSTALL.md](./docs/INSTALL.md).
+
+We'll have a docker image soon too.
 
 To uninstall:
 
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index 57828c04e..220b79dab 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -7,6 +7,7 @@ This file documents all the ways by which you can install d2.
 - [install.sh](#installsh)
 - [Standalone](#standalone)
 - [macOS (Homebrew)](#macos-homebrew)
+- [From Source](#from-source)
 
 <!-- tocstop -->
 
@@ -66,3 +67,9 @@ For macOS you may install as so:
 brew tap terrastruct/d2
 brew install d2
 ```
+
+## From Source
+
+```sh
+go install oss.terrastruct.com/d2/cmd/d2@latest
+```