diff --git a/docs/Updating-Firefox-PWA-Connector.md b/docs/Updating-Firefox-PWA-Connector.md
new file mode 100644
index 0000000..c8c1feb
--- /dev/null
+++ b/docs/Updating-Firefox-PWA-Connector.md
@@ -0,0 +1,15 @@
+How to create new version of the Firefox PWA Connector:
+
+- Check Firefox PWA repo for new version.
+- Pull latest changes of repo and check out proper tag.
+- Run `cargo vendor` in the repo.
+- Create tarball of vendored cargo deps: `tar -czvf vendor-X.Y.Z.tar.gz vendor/`.
+- Move vendor tarball to the overlay files repo under `www-plugins/firefox-pwa-connector`.
+- Push vendored tarball for new version.
+- Copy over ebuild to new version.
+- Check the Cargo.toml of the connector for any new git deps, and add to
+  the git crates if necessary. Cargo.lock can be checked to find the
+  proper commit hashes.
+- Run `ebuild clean install` and make sure everything ends up where its
+  supposed to be. A sandbox violation likely indicates need for new
+  `sed` to patch Maefile.toml to respect `DESTDIR`.