diff --git a/software/theia/README.md b/software/theia/README.md
index 878065a0103711f1b167e17673d28661167c196b..f64cffa4256e552be3e46f0733bfed78d1314098 100644
--- a/software/theia/README.md
+++ b/software/theia/README.md
@@ -13,3 +13,14 @@ To install vscode's python plugin ( https://code.visualstudio.com/docs/languages
 Check theia's log files in case of issues.
 
 see https://github.com/theia-ide/theia/wiki/Testing-VS-Code-extensions for more details.
+
+## jedi
+
+[jedi](https://github.com/davidhalter/jedi) which is used by both thiea and vscode python plugins has
+some support for `zc.buildout`. It looks up for a `buildout.cfg` file and if found will load all scripts
+from the bin directory from this buildout to add eggs to sys.path. In webrunner we have almost 100 scripts
+in bin directory, with maybe 30 eggs in each scripts, so this makes jedi so slow it's unusable. Also, if
+an error occurs parsing these scripts, jedi won't be usable. This issue is tracked in
+https://github.com/davidhalter/jedi/issues/1325
+
+A simple workaround is to create and empty `buildout.cfg` file at the root of project folder.
\ No newline at end of file