diff --git a/developer-tools.md b/developer-tools.md
index 633be7473e..bce821d8c6 100644
--- a/developer-tools.md
+++ b/developer-tools.md
@@ -494,6 +494,26 @@ in the Eclipse install directory. Increase the following setting as needed:
 256M
 ```
 
+<h4>IDE with sbt</h4>
+
+When you use IDEs like VSCode or Cursor and you build from terminal with `sbt`,
+a common issue you'll encounter is something like
+
+```
+java.lang.RuntimeException: Failed to find name hashes for
+```
+
+This is because multiple instances are trying to build the project simultaneously. Normally
+the culprit is your Java/Scala plugin in your IDEs.
+
+In order to fix this, first you need to disable auto-build of your plugins. Then you need to
+clear all the artifacts with `sbt clean`. You'll also need to clear cache in
+
+```
+~/.m2
+~/.ivy2/
+```
+
 <a name="nightly-builds"></a>
 <h3>Nightly builds</h3>
 
diff --git a/site/developer-tools.html b/site/developer-tools.html
index 9d6b200296..4886f3c57b 100644
--- a/site/developer-tools.html
+++ b/site/developer-tools.html
@@ -628,6 +628,24 @@ <h4>Eclipse</h4>
 256M
 </code></pre></div></div>
 
+<h4>IDE with sbt</h4>
+
+<p>When you use IDEs like VSCode or Cursor and you build from terminal with <code class="language-plaintext highlighter-rouge">sbt</code>,
+a common issue you&#8217;ll encounter is something like</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>java.lang.RuntimeException: Failed to find name hashes for
+</code></pre></div></div>
+
+<p>This is because multiple instances are trying to build the project simultaneously. Normally
+the culprit is your Java/Scala plugin in your IDEs.</p>
+
+<p>In order to fix this, first you need to disable auto-build of your plugins. Then you need to
+clear all the artifacts with <code class="language-plaintext highlighter-rouge">sbt clean</code>. You&#8217;ll also need to clear cache in</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>~/.m2
+~/.ivy2/
+</code></pre></div></div>
+
 <p><a name="nightly-builds"></a></p>
 <h3>Nightly builds</h3>