diff --git a/README.md b/README.md
index fe74300c..cdf9b15b 100644
--- a/README.md
+++ b/README.md
@@ -33,21 +33,22 @@ systemctl --user enable --now code-server
 # Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
 ```
 
-### Arch
-
-We publish code-server releases to the our [AUR package](https://aur.archlinux.org/packages/code-server/).
-Use your favorite AUR helper to install. Ours is [yay](https://github.com/Jguer/yay).
+### Arch Linux
 
 ```bash
+# Installs code-server from the AUR using yay.
 yay -S code-server
+systemctl --user enable --now code-server
+# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
 ```
 
-Alternatively, build the package yourself from the [Github repo](https://github.com/cdr/code-server-aur).
-
 ```bash
-git clone https://github.com/cdr/code-server-aur
-cd code-server-aur
+# Installs code-server from the AUR with plain makepkg.
+git clone https://aur.archlinux.org/code-server.git
+cd code-server
 makepkg -si
+systemctl --user enable --now code-server
+# Now visit http://127.0.0.1:8080. Your password is in ~/.config/code-server/config.yaml
 ```
 
 ### yarn, npm
diff --git a/ci/README.md b/ci/README.md
index 57ebfcdf..5d12a670 100644
--- a/ci/README.md
+++ b/ci/README.md
@@ -28,7 +28,11 @@ Make sure you have `$GITHUB_TOKEN` set and [hub](https://github.com/github/hub)
    1. CI will automatically grab the artifacts and then:
       1. Publish the NPM package from `npm-package`.
       2. Publish the Docker Hub image from `release-images`.
-9. Update the homebrew and AUR packages.
+9. Update the AUR package.
+   - Instructions on updating the AUR package are at [cdr/code-server-aur](https://github.com/cdr/code-server-aur).
+10. Wait for the npm package to be published.
+11. Update the homebrew package.
+    - Send a pull request to [homebrew-core](https://github.com/Homebrew/homebrew-core) with the URL in the [formula](https://github.com/Homebrew/homebrew-core/blob/master/Formula/code-server.rb) updated.
 
 ## dev