diff --git a/docs/developers-guide-osx.md b/docs/developers-guide-osx.md
index 0596e9e57cc40dcb3570b0dc4f94a4775390dbb9..0889fa63415f1d456ff1d8ec75e6fbd8d6a3674a 100644
--- a/docs/developers-guide-osx.md
+++ b/docs/developers-guide-osx.md
@@ -107,6 +107,10 @@ After following the configuration steps above, to build and release the app you
     cp path/to/metabase.jar OSX/Resources/metabase.jar
     ```
     
+1. Bump version number (`tag`) in `./bin/version.properties` unless uberjar was built locally
+
+   The build script reads this file, which is generated by `./bin/build`; it assumes the uberjar was built locally, which is a bad assumption. This is something we should fix
+    
 1. Bundle entire app, and upload to s3
 
     ```bash